SparkAds

dev.sparkads由 sparkads.dev 發布官方發布者v1.0.0更新於 Oct 24, 2026

Manage your SparkAds slot: your stats, the free-hour grid, network totals, and your own creative.

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

概覽

AI 產生的概覽

SparkAds 遠端 MCP 伺服器,讓助理讀取廣告主自身的投放數據、查看已佔用與空閒時段,並編輯其廣告卡片。

可以做什麼
  • 讀取廣告主自己近 30 天的投放成效:依日期、依應用程式、依流量來源的曝光與點擊,以及其擁有的素材與審核狀態。
  • 查看已佔用的整點時段:UTC 小時、目標國家當地時間、國家、該時段投放的卡片與審核狀態,以及廣告目前是否真的在投放。
  • 列出網路 24 個時段中尚未被佔用的時段,可選擇回傳當地時鐘時間及依當地晚間關注度排名的前五名。
  • 讀取整個網路近 24 小時的公開總量:曝光、點擊、顯示輪播的應用程式數以及已佔用時段數。
  • 編輯廣告主的廣告卡片,只修改傳入的欄位。
適用情境
適用於在 SparkAds 網路上投放的廣告主,希望由助理檢視投放成效、了解還有哪些時段空閒,或在不開啟後台的情況下調整廣告卡片時。
執行需求
需要 sparkads.dev 上的遠端 streamable HTTP 端點;未宣告任何套件、環境變數或請求標頭。存取範圍限於 API 金鑰持有者,因此隱含需要廣告主帳號及其金鑰。
安裝前請注意
編輯素材的工具會寫入且有代價:儲存後卡片狀態會重設為待審核,廣告將停止投放,直到有人重新核准;操作前應先取得使用者同意。數據僅限金鑰持有者自己的帳號。網路總量是公開庫存數字,並非廣告主自身數據。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "sparkads": {
      "type": "http",
      "url": "https://sparkads.dev/api/mcp/mcp"
    }
  }
}

工具

5

get_my_stats

Get this advertiser's own ad performance for the last 30 days: impressions and clicks split by day, by app in the Spark network, and by traffic source, plus every creative they own with its review status. Read-only. Scoped to the API key holder; it cannot report on anyone else.

無需輸入參數。

get_slot

Get the hour this advertiser holds: the UTC hour, the same hour on their target country's clock, the country itself, and the card that runs in it with its review status. Also reports whether the ad is actually live right now, which needs all three of a held hour, an approved card and a paying subscription. Read-only.

無需輸入參數。

list_free_slots

List the UTC hours nobody has claimed yet, out of the 24 the network sells. Pass a country to also get each free hour on that country's clock and the best five ranked by local evening attention. Supported countries: GB, IE, PT, FR, DE, ES, IT, NL, BE, SE, NO, DK, PL, CH, AT, NG, FI, GR, RO, UA, EG, ZA, IL, SA, TR, RU, KE, AE, PK, IN, BD, TH, VN, ID, CN, SG, MY, PH, HK, TW, AU, JP, KR, NZ, BR, AR, US, CA, PE, CO, MX. Read-only; claiming an hour still happens on the website.

輸入參數country

get_network_pulse

Get the whole network's last 24 hours: total impressions, total clicks, how many apps showed the carousel, and how many of the 24 hourly slots are taken. This is the public inventory figure, the same one the SparkAds landing page prints, not this advertiser's own numbers. Read-only.

無需輸入參數。

update_creative

Edit this advertiser's ad card. Pass only the fields to change; anything omitted keeps its current value. WRITE TOOL, and it costs something: saving resets the card's status to 'pending', so the ad STOPS running until a person approves it again. Say that to the user and get their agreement before calling this. Caps: name 40 characters, tagline 60, one-sentence body 160, url must be https, domain must be a bare hostname like myapp.com. House style: plain words, no exclamation marks, and the sentence says what the product does rather than why it is good.

輸入參數urlbodynamedomaintagline

版本歷史

1
  1. v1.0.0最新Sep 18, 2026

評分

已滿足適用檢查項的 83%

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

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

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。