1688のすべての接続先です。RESTとMCPは同じツールを提供する2つのインターフェースです。

MCPの接続先は、ほかの公開中プラットフォームと同じ形式：ホストと /mcp/ のプレフィックスは共通で、末尾だけが 1688です。末尾を別のプラットフォーム名に置き換えると、そのプラットフォームのエンドポイントになります。

3つの接続方法から選べます。認証、計測、キャッシュはすべてクラウド側で行い、上流のキーはローカルに保存しません。

# Claude Code：1つのコマンドで接続
claude mcp add --transport http claudebaby-1688 https://claudebaby.cn/mcp/1688 \
  --header "Authorization: Bearer $CB_KEY"

# 接続後、セッションで/mcpを実行するとツールを確認できます

{
  "mcpServers": {
    "claudebaby-1688": {
      "type": "http",
      "url": "https://claudebaby.cn/mcp/1688",
      "headers": { "Authorization": "Bearer <あなたのAPIキー>" }
    }
  }
}

# ローカルstdio：キーを端末に保存せず、データ取得はクラウドゲートウェイ経由
uv tool install --from "git+https://github.com/lingling1989r/claudebaby.git#subdirectory=mcps" claudebaby-mcp
CLAUDEBABY_API_KEY=cb_live_xxx claudebaby-mcp --platform 1688

キーはコンソールで発行され、平文は一度だけ表示されます。残高不足の場合は insufficient_balance（HTTP 402）。

ツール名はRESTパスの末尾と同じです。同じツールをMCPからも利用でき、同じenvelopeが返されます。

合計 5 件のエンドポイント。

例では anker を検索語として1688の ali1688_product_search。検索語はツールの実際の引数に設定済みです。ほかの必須項目はプレースホルダーなので、 <…> を自分の値に置き換えてください。パラメーターと説明は上のエンドポイント一覧、またはhttps://claudebaby.cn/v1/ecommerce/1688/toolsをご覧ください。

export CB_KEY=cb_live_xxx

curl -s -X POST https://claudebaby.cn/v1/ecommerce/1688/tools/ali1688_product_search \
  -H "Authorization: Bearer $CB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"node_id": "<node_id>", "supplier_name": "anker", "price_min": "<price_min>"}'

{
  "ok": true,
  "data": {
    "…": "ali1688_product_searchのレスポンス。フィールドはツールによって異なります"
  },
  "meta": {
    "platform": "1688",
    "domain": "ecommerce",
    "tool": "ali1688_product_search",
    "request_id": "req_…",
    "credits": "<今回の消費クレジット。/pricing.jsonを参照>"
  }
}

実際のレスポンスは呼び出して確認してください（エンドポイントとルートに応じて課金）— 上の data は形式の例で、架空のデータではありません。ブラウザーから直接試すには、 API詳細 自分のキーを入力してください。

チャージまたはプランを選択できます。有料取得前にクレジットを確保し、残高不足時は拒否します。

通常のEC照会は1回1クレジット。×N表示は1回Nクレジットです。複合処理とページは個別計算。実行前に確保し、成功で確定、失敗で解放、タイムアウトは確認待ちです。

価格未確認のエンドポイントは一時的に利用できません。代替ルートの見積もりには失敗した主ルートのコスト予算を含みます。実際の台帳をご確認ください。

1回あたりの消費クレジット = 1回のクレジット × 実行回数。1クレジット = ¥0.02です。各エンドポイントの料金区分は /pricing.json（プラットフォーム別料金を含む）をご覧ください。