開発者・AI向けAPI

巻物の検索。作りたいことをそのままクエリに入れられます。

curl "https://makimono-md.vercel.app/api/v1/search?q=meet 自動参加&free_only=true"

# パラメータ:
#   q                  検索語 (スペース区切りAND)
#   category           カテゴリ名
#   tag                タグ
#   free_only          true で無料のみ
#   price_max          価格上限 (円)
#   max_content_tokens 読込コスト上限 (AIのトークン予算管理用)
#   sort               popular | newest | savings | rating | roi
#   limit              最大件数 (デフォルト20)

# レスポンス (抜粋。数値は取得時点の例):
# {
#   "ok": true,
#   "results": [{
#     "slug": "meet-auto-broadcast",
#     "title": "Google Meet 自動参加&動画配信Bot 開発指示書",
#     "saved_tokens": 832000,     // 節約トークン
#     "content_tokens": 1864,     // このMD自体の読込コスト
#     "roi": 446,                 // 読込1トークンあたりの節約
#     "is_free": true,
#     "links": { "meta": "...", "raw": "...", "human": "..." }
#   }],
#   "_ai_note": "次のアクション: ..."
# }

巻物のメタデータ (JSON)。本文を含まないので軽量です。

curl "https://makimono-md.vercel.app/api/v1/files/meet-auto-broadcast"

MD本文そのもの (text/markdown)。AIはこのURLを直接読み込んで指示書として使えます。有料出品は冒頭プレビュー + HTTP 402 を返します。

curl "https://makimono-md.vercel.app/api/v1/files/meet-auto-broadcast/raw"

# Claude Code ならワンライナーで:
claude "https://makimono-md.vercel.app/api/v1/files/meet-auto-broadcast/raw を読み込んで、この指示書どおりに実装して"

カテゴリ一覧と件数。

curl "https://makimono-md.vercel.app/api/v1/categories"

出品者APIキーを発行 (メールアドレスにひも付く)。

curl -X POST "https://makimono-md.vercel.app/api/v1/keys" \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

# → { "ok": true, "apiKey": "mk_...." }  (再表示されないので保管)

出品する。Authorization: Bearer <apiKey> が必須。秘密情報スキャンを通過すると pending に入る。

curl -X POST "https://makimono-md.vercel.app/api/v1/listings" \
  -H "Authorization: Bearer $MAKIMONO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "...(5文字以上)",
    "summary": "...(20文字以上)",
    "category": "業務自動化",
    "body": "# 指示書本文 ...(200文字以上・秘密情報は禁止)",
    "scratchTokens": 500000,
    "withMdTokens": 60000,
    "price": 0
  }'

# → { "ok": true, "submissionId": "sub_...", "status": "pending" }

巻物を使ってトークンが減った実績を報告 (任意)。集計は GET で取得可能。

curl -X POST "https://makimono-md.vercel.app/api/v1/report" \
  -H "Content-Type: application/json" \
  -d '{"slug":"meet-auto-broadcast","savedTokens":832000,"model":"claude-fable-5"}'