Clickwise Affiliate Network

Clickwise API：GTIN による商品検索、アフィリエイトリンクのトラッキング、MCP

Clickwise は、開発者と AI エージェント向けに構築された API を備えるアフィリエイトネットワークです。各ネットワークの GTIN 付き商品フィードを検索し、あなた専用のトラッキング付き商品リンクを取得し、アフィリエイトプログラムを探して参加し、コンバージョンを取得できます。REST、MCP 経由の AI エージェント、または HasOffers 互換ツールから利用できます。

このリポジトリでは、クイックスタート、軽量クライアント、MCP 設定、デプロイ可能なアフィリエイトストアを使って、すぐに動作する API 呼び出しを始められます。

1. キーなしで最初の API 呼び出し

# How big is the catalog right now?
curl -s https://partners.clickwise.net/api/v1/public/catalog-stats/

# Sample products in one market (DE, ES, GB, PT, SE, FR, US); no links without a key
curl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"

# Ask the MCP server which programs fit your site
curl -s https://partners.clickwise.net/api/v1/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_affiliate_programs","arguments":{"topic":"sneakers","country":"ES","channel":"site"}}}'

2. キーを取得する

https://partners.clickwise.net/developers/ からパブリッシャー API キーをリクエストしてください。環境変数に設定し、サーバー上で管理してください。

export CLICKWISE_API_KEY=...   # never commit it, never ship it to a browser

3. キーを使って最初の API 呼び出し

# Who am I, what can this key do, what are my limits?
curl -s https://partners.clickwise.net/api/v1/publisher/me/ -H "X-API-Key: $CLICKWISE_API_KEY"

# Price, stock and YOUR tracked link for up to 100 GTINs
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/lookup/ \
  -H "X-API-Key: $CLICKWISE_API_KEY" \
  --data-urlencode 'gtins=4006381333931,5901234123457' --data-urlencode 'country=DE'

# Search by title in one market
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \
  -H "X-API-Key: $CLICKWISE_API_KEY" \
  --data-urlencode 'q=sneaker' --data-urlencode 'country=GB' --data-urlencode 'limit=20'

# Same kind of search in Germany (publisher key or sandbox key)
curl -s --get https://partners.clickwise.net/api/v1/publisher/products/ \
  -H "X-API-Key: $CLICKWISE_API_KEY" \
  --data-urlencode 'q=smartwatch' --data-urlencode 'country=DE' --data-urlencode 'limit=20'

各商品は {"gtin", "title", "price", "currency", "image", "url", "merchant", "availability", ...} の形式で返されます。url はあなた専用のトラッキング付きリンクです。返されたとおりにそのまま掲載してください。

手順 1 と 3 の実行可能なバージョンはこちらです：quickstart/curl.sh · quickstart/quickstart.mjs（Node 18 以降）· quickstart/quickstart.py（Python 3.8 以降）。依存関係はありません。

4. AI エージェントから利用する（MCP）

リモート MCP サーバー（Streamable HTTP）：https://partners.clickwise.net/api/v1/mcp。公式 MCP Registry には net.clickwise/mcp として登録されています。ツールは 19 個で、キーは任意です（プログラムの検索、取引情報、カタログ統計はキーなしで利用できます）。

claude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"

Claude Code、Cursor、Claude Desktop、VS Code、ChatGPT、Grok、n8n 向けの設定と、ツール一覧は mcp/ をご覧ください。

AI アシスタントから収益を得る方法（商品検索、サブ ID、署名付きポストバック）：quickstart/monetize-agent.md。

5. アフィリエイトストアを公開する

templates/affiliate-store：GTIN で商品を取得し、最新価格を表示して、トラッキング付きリンクを掲載する Next.js ストアフロントです。プレビューモードではキーなしでデプロイできます。

Lovable、Bolt、v0 を使って開発していますか？templates/affiliate-store/PROMPT.md を貼り付けてください。

独自のアプリや SaaS を運用していますか？templates/merchant-tracking/PROMPT.md を Lovable、Bolt、v0 に貼り付けると、Stripe、Lemon Squeezy、またはコンバージョン API を使った Clickwise の売上トラッキングを追加できます。

6. クライアント

OpenAPI から生成された、依存関係のない軽量クライアントです。各操作に 1 つのメソッドを用意しています。

• TypeScript：clients/typescript/clickwise.ts（ファイルを 1 つコピーするだけ。Node、Bun、Deno、エッジで利用できます）。
• Python：clients/python（pip install "git+https://github.com/softdevfz/clickwise-api#subdirectory=clients/python"）。

const cw = new Clickwise(); // CLICKWISE_API_KEY
const { products } = await cw.lookupProducts({ gtins: "4006381333931", country: "DE" });

API の対象範囲

領域	エンドポイント（/api/v1/publisher/…）
商品	GET products/ 検索 · GET products/lookup/ ID または GTIN で検索（1～100）
プログラム	GET programs/ · GET programs/joinable/ · POST programs/apply/
リンク	GET/POST links/ · POST links/batch/（最大50件、各項目に個別のステータス）
レポート	GET conversions/ · GET reports/（日、週、月、サブID、キャンペーン、ステータス） · GET clicks/
ポストバック	GET postback/ · POST postback/test/ · GET postback/deliveries/（署名付き HMAC Webhook）
アカウント	GET me/：キーのアクセス権とレート制限

エラー形式は統一されています（{"error": {"code", "message", "status", "request_id"}}）。すべてのレスポンスに RateLimit-* ヘッダーが付き、429 には Retry-After、POST には Idempotency-Key、すべてに X-Request-Id が付きます。v1 内の変更は追加のみです。

リファレンス

• 開発者ハブ：https://partners.clickwise.net/developers/
• OpenAPI 3.1：https://partners.clickwise.net/api/v1/publisher/openapi.json（スナップショットは openapi/ にあります）
• Postman コレクション：https://partners.clickwise.net/api/v1/publisher/postman.json
• LLM 向け：https://partners.clickwise.net/llms.txt
• MCP：https://partners.clickwise.net/api/v1/mcp
• HasOffers/TUNE 互換のアフィリエイト API：https://partners.clickwise.net/Apiv3/json

利用上の注意

• キーはサーバー上に保管してください。キーは自身のアカウントに対してのみ機能し、管理者アクセス権を持つことはありません。
• 商品とトラッキングリンクは返されたとおりに掲載し、アフィリエイト関係を開示してください（リンクには rel="sponsored" を設定し、目に見える形で開示してください）。
• 価格は少なくとも48時間ごとに更新してください。検索で返されなくなった商品は非表示にしてください。
• レート制限を遵守し、429 が返された場合は Retry-After に従って間隔を空けて再試行してください。

サポート

ご質問や統合に関するサポート：[email protected]。このリポジトリのバグについては、issue を作成してください。

ライセンス

MIT © SOFT DEV FZ LLC (Clickwise)。Clickwise API 自体の利用には、Clickwise パブリッシャーアカウントの利用規約が適用されます。