Clickwise Affiliate Network

net.clickwise由 clickwise.net 發布官方發布者v1.8.0更新於 Nov 7, 2026

Affiliate programs, deals, tracked links and product search, plus merchant program setup tools.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析商業與電商

概覽

AI 產生的概覽

把助理接入 Clickwise 聯盟網路,用來尋找聯盟計畫、取得追蹤連結、依 GTIN 搜尋商品,並讀取聯盟或商家資料。

可以做什麼
  • 尋找與瀏覽聯盟計畫、檢查商店網域、申請加入計畫並列出已核准的計畫
  • 建立追蹤連結、在沒有帳號時申請臨時連結,並查詢連結申請狀態
  • 依文字或 GTIN 搜尋商品、取得依國家簽署的商品資料來源與公開目錄統計
  • 列出優惠、每週優惠與公告,並可依 slug 取得完整紀錄
  • 讀取聯盟報表:點擊、轉換、依期間或 subid 的佣金,以及付款狀態
  • 商家工具:建立計畫、回答申請問題、簽發測試連結、首次顯示或輪換轉換金鑰,並讀取整合狀態與成效結果
適用情境
適合讓助理推薦可推廣的商家、產生聯盟追蹤連結、依 GTIN 查詢商品與價格,或彙整聯盟帳號的點擊、轉換與付款情況。也適用於商家建立 Clickwise 計畫並檢查銷售追蹤。
執行需求
遠端 Streamable HTTP 端點,不需本機安裝套件。可選密鑰:X-API-Key 聯盟金鑰(免費 14 天沙箱金鑰可用於商品搜尋與 GTIN 查詢),以及商家工具所需的 Authorization 商家 Bearer 權杖。計畫探索、優惠、目錄統計與臨時追蹤連結不需金鑰。
安裝前請注意
涉及兩個可選密鑰:X-API-Key 與商家 Authorization Bearer 權杖,應保存在伺服器端。多個工具會建立或修改資料:臨時聯盟帳號與追蹤連結、個人資料與收款資訊、計畫申請、含佣金條款的計畫建立,以及轉換金鑰輪換。商家工具可能一次性顯示新的轉換金鑰。佣金只支付給已認領帳號,且僅限商家核准的銷售;連結屬於聯盟連結,應加以揭露。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clickwise Affiliate Network,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/net.clickwise%2Fmcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "clickwise-affiliate-network": {
      "type": "http",
      "url": "https://partners.clickwise.net/api/v1/mcp"
    }
  }
}

README

Clickwise API: products by GTIN, tracked affiliate links, MCP

[MCP Registry] [OpenAPI 3.1] [License: MIT]

Clickwise is an affiliate network with an API built for developers and AI agents. Search product feeds with GTINs from the networks, get product links tracked to you, find and join affiliate programs, and pull your conversions. Use it over REST, from an AI agent through MCP, or from HasOffers-compatible tools.

This repo gets you from zero to a working call: quickstarts, thin clients, MCP configs and a deployable affiliate store.

1. First call, no key

sh
# 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 keycurl -s "https://partners.clickwise.net/api/v1/public/catalog-sample/?country=DE"
# Ask the MCP server which programs fit your sitecurl -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. Get your key

Request a publisher API key at https://partners.clickwise.net/developers/. Put it in an environment variable and keep it on your server:

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

3. First call with your key

sh
# 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 GTINscurl -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 marketcurl -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'

Each product comes back as {"gtin", "title", "price", "currency", "image", "url", "merchant", "availability", ...}. url is your tracked link: publish it exactly as returned.

Runnable versions of steps 1 and 3: quickstart/curl.sh · quickstart/quickstart.mjs (Node 18+) · quickstart/quickstart.py (Python 3.8+). No dependencies.

4. Use it from an AI agent (MCP)

Remote MCP server (Streamable HTTP): https://partners.clickwise.net/api/v1/mcp, listed in the official MCP Registry as net.clickwise/mcp. The key is optional: program discovery, deals, catalog stats and provisional tracked links work without it.

sh
# Claude Codeclaude mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp --header "X-API-Key: $CLICKWISE_API_KEY"
# OpenAI Codex CLIcodex mcp add clickwise --url https://partners.clickwise.net/api/v1/mcp
# Gemini CLIgemini mcp add --transport http clickwise https://partners.clickwise.net/api/v1/mcp

Plugins, extensions and skills

  • Claude Code plugin (MCP server plus the skill below): /plugin marketplace add softdevfz/clickwise-api, then /plugin install clickwise@clickwise. Set CLICKWISE_API_KEY in your environment to use the tools that need a key.
  • Codex plugin (same MCP server and skill): codex plugin marketplace add softdevfz/clickwise-api, then codex plugin add clickwise@clickwise. The key, if set, is read from CLICKWISE_API_KEY.
  • Antigravity CLI plugin: agy plugin install https://github.com/softdevfz/clickwise-api.
  • Gemini CLI extension: gemini extensions install https://github.com/softdevfz/clickwise-api. It adds the MCP server and GEMINI.md as context.
  • Agent Skill for any agent that reads SKILL.md (Claude, Codex and others): skills/clickwise-affiliate-links. Copy the folder into your agent's skills directory.

Configs for Claude Code, Cursor, Claude Desktop, VS Code, ChatGPT, Grok and n8n, plus the tool list, in mcp/.

Earn commission from your AI assistant (product search, sub-IDs and signed postbacks): quickstart/monetize-agent.md.

5. Ship an affiliate store

templates/affiliate-store: a Next.js storefront that reads products by GTIN, shows live prices and publishes your tracked links. It deploys without a key in preview mode.

[Deploy with Vercel] [Deploy to Netlify]

Building with Lovable, Bolt or v0? Paste templates/affiliate-store/PROMPT.md.

Running your own app or SaaS? Paste templates/merchant-tracking/PROMPT.md into Lovable, Bolt or v0 to add Clickwise sales tracking with Stripe, Lemon Squeezy or the conversions API.

WooCommerce: import the Clickwise product feed with WP All Import → guides/woocommerce/wp-all-import.md

6. Clients

Thin, dependency-free clients generated from the OpenAPI, one method per operation:

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

What the API covers

AreaEndpoints (/api/v1/publisher/…)
ProductsGET products/ search · GET products/lookup/ by id or GTIN (1–100)
ProgramsGET programs/ · GET programs/joinable/ · POST programs/apply/
LinksGET/POST links/ · POST links/batch/ (up to 50, each with its own status)
ReportingGET conversions/ · GET reports/ (day, week, month, sub-ID, campaign, status) · GET clicks/
PostbacksGET postback/ · POST postback/test/ · GET postback/deliveries/ (signed HMAC webhooks)
AccountGET me/: access and rate limits for your key

One error shape ({"error": {"code", "message", "status", "request_id"}}), RateLimit-* headers on every response, Retry-After on 429, Idempotency-Key on POST, X-Request-Id everywhere. Changes inside v1 are additive.

Reference

Rules of the road

  • Keep the key on your server. A key acts only for its own account and never has admin access.
  • Publish product and tracking links exactly as returned, and disclose affiliate relationships (rel="sponsored" on links plus a visible disclosure).
  • Refresh prices at least every 48 hours; hide products a lookup no longer returns.
  • Honour rate limits: back off on 429 using Retry-After.

Support

Questions and integration help: [email protected]. Bugs in this repo: open an issue.

License

MIT. Use of the Clickwise API itself is subject to your Clickwise publisher account terms.

來源:README.md,提交 e1bd7eb

工具

31

search_products

Search catalog products

Search fresh GTIN products in the catalog your affiliate can deliver (freshness, permissions and caps apply). Requires your affiliate API key in X-API-Key or Bearer authorization; a sandbox key (cw_sbx_, free at partners.clickwise.net/developers) also works; sandbox links are examples and do not track clicks or earn commission. Every key gets exactly the REST GET /api/v1/publisher/products/ format (with gtin: /products/lookup/): products with id, gtin, title, price and currency, url (a Clickwise /dl/ tracked link created for your affiliate the first time a product is returned), image, merchant (id, name and its public website domain), availability, country, brand, category, regular_price, description, size, color and group_id (shared by the sizes of one model and colour), plus count, total and total_exact. Search by text, brand or category, or list one market by country alone; min_price and max_price filter by price in each product's own currency (inclusive, no conversion) and currency keeps one currency; with gtin every market carrying that GTIN is searched; offset paginates. Example: text "smartwatch" with country "DE" returns offers with a publisher key or a sandbox key. Add currency "EUR" to keep only euro prices.

輸入參數gtintextbrandlimitsubidoffsetcountrycategorycurrencymax_pricemin_price

get_product_feed

Get product feed URL

Create or refresh a GTIN product feed for your authenticated affiliate and one country, and return its signed URL (json, csv, tsv or xml) with Clickwise /dl/ tracked product links. The same request returns the same URL. Requires your affiliate API key. Current freshness, permissions, assignments and delivery caps apply.

輸入參數formatcountry必填category

get_catalog_stats

Get catalog statistics

Public GTIN catalog counts as of generated_at, using the same stored snapshot as /api/v1/public/catalog-stats/. Fixed one-hour validity; snapshot_stale marks older counts, served for up to 7 days. No affiliate data or amounts.

無需輸入參數。

list_deals

List deals

List active Clickwise deals and offers, optionally filtered by language, category, country or merchant.

輸入參數langlimitcountrynetworkcategorymerchant

get_deal

Get deal

Fetch the full record for a single deal by its slug. Returns title, description, code, discount, target_url, etc., in the requested language.

輸入參數langslug必填

list_news

List program news

List Clickwise news announcements about affiliate programs (policy changes, launches, shutdowns, commission updates).

輸入參數langlimitnetworkseverity

get_news

Get news article

Fetch the full record for a single news article by its slug.

輸入參數langslug必填

find_affiliate_programs

Find affiliate programs

Use this first when someone without a Clickwise account asks which merchants to promote: it ranks live programs by fit for a described site, app, newsletter or social channel. Does not require signup. For the whole catalogue page by page use list_programs; for the programs your API key is already approved in use list_my_programs.

輸入參數limittopicchannelcountrynetworkcategorymerchantpublisher_urltraffic_dailyinclude_unreadytraffic_monthly

get_monetization_feed

Get monetization feed

Use this when a publisher without an account wants links ready to render on a site or app: it creates a provisional Clickwise affiliate and tracked links, as request_tracked_links does, and also returns cards, an HTML embed snippet and a JSON feed. Email is optional; the account is claimed later for payout. For plain links use request_tracked_links; with an existing API key use create_tracking_links.

輸入參數limittopicsub_idcountrycategoryclaim_emailprogram_idspublisher_url

request_merchant_onboarding

Request merchant onboarding

Alias of create_program. Create a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).

輸入參數langcountrymessagewebsiteverticalcommissioncookie_dayscompany_nameproduct_typecontact_emailnetworks_usedpricing_model另有 5 個

list_programs

List programs

Use this to browse the whole live catalogue page by page, filtered by merchant, category or country, when find_affiliate_programs' ranked top matches are not enough. No key needed; it shows programs anyone can join. For the programs your API key is approved in use list_my_programs.

輸入參數pagecountrynetworkcategorymerchantpage_sizeready_only

update_profile

Update creator profile

Update a creator's monetization profile (claim email, display name, website, country, payment method) using the application_id + access_secret returned by request_tracked_links. Overwrites the fields provided. Lets a creator's assistant complete claim/payout details without leaving chat.

輸入參數countryclaim_emailwebsite_urldisplay_nameaccess_secret必填application_id必填payment_method

get_click_report

Get click report

Your own native Clickwise redirect clicks for an inclusive date range. Returns individual clicks and total, excluding bots by default; upstream network clicks are not included. The REST resource has no grouping. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

輸入參數pagesub_iddate_todate_frompage_sizecampaign_iddeeplink_id

list_my_programs

List my programs

Use this when you hold a Clickwise affiliate API key and need the programs that key is approved to promote, with link readiness and your existing link count; set include_available to add the ones you can apply to. For discovery without an account use find_affiliate_programs or list_programs. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

輸入參數pagesearchpage_sizeinclude_available

get_performance_report

Get performance report

Your conversions and commission (what you earn), grouped by day, week, month, subid, campaign or status, for up to 366 days (default: last 30). Daily/weekly/monthly series include empty periods. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

輸入參數subidstatusdate_togroup_bydate_from

list_conversions

List conversions

Your individual conversions (default: last 90 days) with status, commission, currency and subid, plus a per-subid rollup. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

輸入參數pagesubidstatusdate_todate_frompage_size

get_payment_status

Get my payment status

Use this when an affiliate asks when they get paid: approved commission not yet paid (per currency and in USD), commission still pending review, the next payment as an estimate with its threshold, and the payment method as its type (a bank account shows only its last 4 digits). Read-only; never returns account numbers, PayPal addresses, postal or tax data. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

無需輸入參數。

apply_to_program

Apply to a program

Ask to join a program (program_id from list_my_programs with include_available, or a campaign_id). Clickwise reviews the fit; the result is approved or pending. Requires your own Clickwise affiliate API key on the MCP connection (X-API-Key header or Authorization: Bearer); acts only on your account.

輸入參數program_idcampaign_id

list_my_weekly_deals

List my weekly deals

Read the weekly deals available to your Clickwise affiliate account. Returns existing deal details only; no tracked links are created. Requires affiliate:read on your OAuth connection or your own affiliate API key.

輸入參數lang

check_store

Check a store

Check a store domain against the Clickwise catalog. Returns up to five available programs, absent, or a neutral result. Requires an affiliate OAuth connection with affiliate:read. Send a domain only, without a URL or browsing history.

輸入參數domain必填

create_program

Create a merchant program

Create a program for its first payment. An agent calls this at a person's request. Default commission 25%, percent range 10–50%; recurring_months: 0 only. No setup fee; you pay on approved sales. The agent never accepts the Clickwise merchant terms on its own: send terms_accepted with terms_version only after the person has read the merchant terms page and told you they accept them. Otherwise leave it out: the program is not set up until the person accepts them and you send terms_accepted with terms_version, here or later in POST /api/v1/onboarding/merchant/{application_id}/ with the access_secret (required action confirm_terms).

輸入參數langcountrymessagewebsiteverticalcommissioncookie_dayscompany_nameproduct_typecontact_emailnetworks_usedpricing_model另有 5 個

get_program_status

Get program status

Read the application and pending question using application_id and access_secret.

輸入參數access_secret必填application_id必填

answer_program_question

Answer a program question

Answer the application question. An agent calls this at a person's request.

輸入參數langmessageaccess_secret必填terms_versionapplication_id必填terms_acceptedchannel_restrictions

get_merchant_credentials

Get merchant credentials once

get_merchant_credentials: Returns a merchant API token only if the account has none yet. If one exists, it answers 409 and explains where the account holder can copy it. It never reveals an existing token.

輸入參數access_secret必填application_id必填

get_conversions_key

Get a conversions key

Reveal a new conversions key once, or rotate with rotate=true. An agent calls this at a person's request. Merchant Bearer token required.

輸入參數rotate

get_integration_status

Get integration status

Read authenticated test-sale evidence and the last real sale. Merchant Bearer token required.

無需輸入參數。

get_results

Get program results

Read native direct program clicks, pending, approved and rejected conversions, commission by currency and billing status. Merchant Bearer token required.

輸入參數daysgroup_by

版本歷史

10
  1. v1.8.0最新Nov 7, 2026
  2. v1.7.1Oct 31, 2026
  3. v1.7.0Oct 23, 2026
  4. v1.6.3Oct 19, 2026
  5. v1.6.2Oct 13, 2026
  6. v1.6.1Oct 4, 2026
  7. v1.6.0Oct 3, 2026
  8. v1.5.1Oct 3, 2026
  9. v1.5.0Sep 30, 2026
  10. v1.4.0Sep 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Clickwise 整合