Get MCP Ads
官方將Google Ads、Meta Ads、TikTok Ads、Pinterest Ads、Snapchat Ads、Search Console和GA4連接到您的AI助手,透過託管的MCP URL。選擇授權帳戶,免費方案提供唯讀存取,付費方案支援寫入操作的預覽與確認。
你可以用 Get Ads MCP 做什麼?
-
檢查廣告帳戶健康狀態 — 透過
reddit_health_check、bing_health_check或snapchat_health_check查詢所選帳戶的貨幣、時區與狀態。 -
列出廣告活動與廣告 — 使用
reddit_get_campaigns、bing_get_campaigns、snapchat_get_campaigns或meta_get_campaigns擷取原生廣告活動、廣告群組與廣告設定。 -
讀取目標設定 — 透過
reddit_get_targeting、bing_get_targeting、snapchat_get_targeting或meta_get_adset_configuration拉取實際的包含條件、排除條件、地理與人口統計資料。 -
預覽寫入操作 — 草擬廣告、廣告活動或受眾變更而不實際套用;寫入操作需
confirm: true,且預設保持暫停狀態。 -
取得成效洞察 — 使用明確日期範圍,透過
reddit_get_insights、bing_get_insights、snapchat_get_insights或meta_get_insights查詢原生報表。 -
管理創意素材 — 透過
reddit_list_ad_creatives、bing_list_ad_creatives、snapchat_list_ad_creatives或meta_get_creative_assets列出與廣告關聯的圖片與影片。
託管 MCP 伺服器
npx add-mcp 'https://mcp.getmcpads.com/mcp'可安裝到 Claude Code、Codex、Cursor、VS Code 等客戶端
文件
工具目錄
9 個已記錄來源中實作了 388 個工具。下方的來源存取說明決定了哪些工具可透過 https://mcp.getmcpads.com/mcp. 呼叫。
標記為 (write) 的工具會變更線上帳戶的某些內容。它們預設為預覽模式:
沒有 confirm: true 時,工具只會描述變更而不套用任何內容。Free 方案完全拒絕寫入操作。
工具只會回應組織已勾選的帳戶。任何其他識別碼都會被拒絕,包括底層連線原本可以存取的帳戶。
Reddit Ads(50 個工具,19 個寫入)
外部助理存取正在等待 Reddit 澄清。授權操作員可以管理測試連線;已實作的工具在此有文件記錄,但尚無法公開呼叫。
reddit_create_ad(write):使用原生欄位建立 Reddit 廣告,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=ad_create) 和目前設定。reddit_create_ad_group(write):使用原生欄位建立 Reddit ad_group,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=ad_group_create) 和目前設定。reddit_create_campaign(write):使用原生欄位建立 Reddit campaign,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=campaign_create) 和目前設定。reddit_create_catalog(write):使用原生 schema catalog_create 建立 Reddit catalog。請先預覽。匯入為非同步;請輪詢回傳的 handles。不會啟用廣告。reddit_create_custom_audience(write):使用原生欄位建立 Reddit custom_audience,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=custom_audience_create) 和目前設定。reddit_create_lead_form(write):使用原生欄位建立 Reddit lead_form,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=lead_form_create) 和目前設定。reddit_create_post(write):使用原生 schema post_create 建立 Reddit post。請先預覽。匯入為非同步;請輪詢回傳的 handles。不會啟用廣告。reddit_create_product_set(write):使用原生 schema product_set_create 建立 Reddit product set。請先預覽。匯入為非同步;請輪詢回傳的 handles。不會啟用廣告。reddit_create_saved_audience(write):使用原生欄位建立 Reddit saved_audience,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=saved_audience_create) 和目前設定。reddit_get_ad:讀取一個 Reddit 廣告;驗證它屬於所選的廣告帳戶。reddit_get_ad_group:讀取一個 Reddit ad_group;驗證它屬於所選的廣告帳戶。reddit_get_ad_groups:讀取 Reddit ad_groups,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_ads:讀取 Reddit 廣告,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_asset_uploads:透過所選設定檔輪詢創意素材匯入的處理狀態;ACTIVE 表示媒體已就緒,而非廣告投放中。reddit_get_campaign:讀取一個 Reddit campaign;驗證它屬於所選的廣告帳戶。reddit_get_campaigns:讀取 Reddit campaigns,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_catalog_imports:從擁有的 Reddit catalog 讀取 catalog_imports。reddit_get_catalogs:讀取擁有所選廣告帳戶之企業的產品目錄。reddit_get_creative_assets:列出所選 Reddit 設定檔的資產庫;未使用的檔案不一定是廣告。reddit_get_custom_audience:讀取一個 Reddit custom_audience;驗證它屬於所選的廣告帳戶。reddit_get_custom_audiences:讀取 Reddit custom_audiences,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_insights:原生 Reddit 報告,包含指標和實體/受眾分解、明確的 UTC 日期和分頁。空結果僅驗證傳輸。報告的受眾人口統計與設定的目標不同。reddit_get_lead_form:讀取一個 Reddit lead_form;驗證它屬於所選的廣告帳戶。reddit_get_lead_gen_forms:讀取 Reddit lead_gen_forms,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_pixels:列出所選 Reddit 廣告帳戶可存取的像素。reddit_get_post:在設定檔所有權驗證後讀取廣告結構化貼文。reddit_get_post_job:使用簽署的作業收據輪詢先前建立的結構化貼文。不接受來自其他帳戶的任意作業 ID。reddit_get_posts:列出附加到此帳戶之設定檔的廣告結構化貼文。回傳原生圖片/影片/輪播/文字設定。reddit_get_product_sets:從擁有的 Reddit catalog 讀取 product_sets。reddit_get_products:從擁有的 Reddit catalog 讀取 products。reddit_get_profiles:列出所選 Reddit 廣告帳戶可存取的設定檔。reddit_get_reporting_schema:Reddit 指標和維度清單;設定的目標使用 reddit_get_targeting 讀取,而非從報告推斷。reddit_get_saved_audience:讀取一個 Reddit saved_audience;驗證它屬於所選的廣告帳戶。reddit_get_saved_audiences:讀取 Reddit saved_audiences,包括原生設定和已設定/有效狀態。分頁回傳不透明游標;所有頁面都需要明確的接續。reddit_get_setup_guide:完整的 Reddit 連接器涵蓋範圍、先決條件和即時驗證限制。請勿從初始的簡短工具清單推斷不可用的功能。reddit_get_targeting:讀取實際的廣告群組目標:包含/排除、地理、年齡/性別、語言、興趣、社群、關鍵字、裝置和受眾 ID。這是設定,而非投放人口統計。reddit_get_targeting_options:探索有效的原生目標值。社群可以搜尋;大型清單會分頁或明確標記為部分。reddit_get_write_schema:Reddit 建立和編輯的精確固定原生 schema,包括目標和所有已實作的 campaign/ad 格式。提供者接受與本地 schema 驗證是分開的。reddit_health_check:讀取所選 Reddit 帳戶、貨幣和時區;API 存取並非投放或完整目標資格的證明。reddit_list_ad_creatives:解析廣告連結的圖片/影片/輪播資產並提供明確涵蓋範圍。影片封面不能確立其動態/音訊;請在可用時使用完整媒體。reddit_update_ad(write):使用原生欄位更新 Reddit 廣告,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=ad_update) 和目前設定。reddit_update_ad_group(write):使用原生欄位更新 Reddit ad_group,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=ad_group_update) 和目前設定。reddit_update_asset(write):更新支援的 Reddit 資產欄位;預設為預覽模式。閱讀 reddit_get_write_schema(operation=asset_update)。reddit_update_campaign(write):使用原生欄位更新 Reddit campaign,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=campaign_update) 和目前設定。reddit_update_catalog(write):更新支援的 Reddit catalog 欄位;預設為預覽模式。閱讀 reddit_get_write_schema(operation=catalog_update)。reddit_update_post(write):更新支援的 Reddit post 欄位;預設為預覽模式。閱讀 reddit_get_write_schema(operation=post_update)。reddit_update_product_set(write):更新支援的 Reddit product_set 欄位;預設為預覽模式。閱讀 reddit_get_write_schema(operation=product_set_update)。reddit_update_saved_audience(write):使用原生欄位更新 Reddit saved_audience,包括支援的目標/格式。預設為預覽模式;建立的 campaign/group/ad 一律為 PAUSED。編輯前請閱讀 reddit_get_write_schema(operation=saved_audience_update) 和目前設定。reddit_upload_creative_assets(write):使用原生 schema asset_upload 上傳 Reddit 創意素材。請先預覽。匯入為非同步;請輪詢回傳的 handles。不會啟用廣告。reddit_upsert_products(write):使用原生 schema products_upsert 更新或插入 Reddit 產品。請先預覽。匯入為非同步;請輪詢回傳的 handles。不會啟用廣告。
Microsoft Advertising(39 個工具,20 個寫入)
外部助理存取未啟用。授權操作員可進行沙盒測試和生產帳戶探索。發布者和外部租用戶同意驗證仍在進行中;開發者權杖已取得。
bing_add_ad_group_targeting(write):新增一個原生廣告群組指定條件。編輯前請先讀取目前的指定設定;使用 Targets 進行人口統計/地理編輯,使用 Audience 進行受眾關聯。不會清除未指定的條件。bing_add_campaign_targeting(write):新增一個原生廣告活動指定條件。編輯前請先讀取目前的指定設定;使用 Targets 進行人口統計/地理編輯,使用 Audience 進行受眾關聯。不會清除未指定的條件。bing_create_ad(write):使用原生欄位建立一個 Microsoft Ads 廣告。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_create_ad_group(write):使用原生欄位建立一個 Microsoft Ads 廣告群組。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_create_asset_group(write):建立一個暫停的 Performance Max 資產群組,包含文字/圖片資產。需要符合資格的廣告活動和所有必要資產;本機預覽並非供應商驗證。bing_create_audience(write):使用原生欄位建立一個 Microsoft Ads 受眾。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_create_campaign(write):使用原生欄位建立一個 Microsoft Ads 廣告活動。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_create_conversion_goal(write):建立一個 Microsoft Ads 轉換目標設定。不包含網站安裝或事件注入。請先預覽;轉換目標會以暫停狀態建立,並排除在出價之外。bing_create_keyword(write):使用原生欄位建立一個 Microsoft Ads 關鍵字。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_create_uet_tag(write):建立一個 Microsoft Ads UET 標籤設定。不包含網站安裝或事件注入。請先預覽;轉換目標會以暫停狀態建立,並排除在出價之外。bing_get_ad_groups:讀取所屬廣告活動中的廣告群組和原生設定。bing_get_ads:讀取廣告,包括原生創意資產、URL 和狀態。AdTypes 會明確控制回傳的格式。bing_get_asset_groups:讀取 Performance Max 資產群組,包含原生創意設定和狀態。bing_get_audiences:讀取指定單一類型的可存取受眾設定。空的受眾不代表可比對或可指定。bing_get_campaigns:讀取指定廣告活動類型的原生廣告活動設定、預算、設定和狀態。對其他類型重複操作以盤點整個帳戶。bing_get_conversion_goals:讀取轉換目標設定;這不代表事件正在流動。bing_get_geo_file:取得 Microsoft 目前的地理指定目錄下載連結。請使用其有效的 Location ID;切勿重複使用 Google 的 location ID。bing_get_insights:為所選帳戶提交非同步的 Microsoft Ads 報表。使用 bing_get_report 輪詢已簽署的收據。原生欄位相容性和沙箱資料可用性皆適用。bing_get_keywords:從所屬廣告群組讀取關鍵字、比對類型、出價和狀態。bing_get_media:依 ID 讀取所選帳戶中已上傳的 Microsoft Ads 媒體中繼資料。bing_get_report:輪詢並下載繫結至所選帳戶和環境的 Microsoft Ads 報表。最多回傳 2,000 列 CSV;若被截斷請縮小範圍。空的沙箱輸出並非生產環境的成效證據。bing_get_reporting_schema:讀取固定的 Microsoft 報表類型、支援的原生欄位和官方參考。為相容的報表類型選擇欄位;目錄條目不代表有資料或生產資料。bing_get_setup_guide:Microsoft Ads 連接器涵蓋範圍、沙箱驗證和其餘限制。在宣稱功能對等或支援未支援功能前請先閱讀。bing_get_targeting:依條件類型分別讀取實際設定的廣告活動或廣告群組指定。包含包含/排除條件物件;這是設定,不是人口統計成效。bing_get_uet_tags:讀取 UET 追蹤標籤設定。此操作不會安裝任何網站追蹤程式碼。bing_get_videos:讀取帳戶影片資產和處理狀態。Active 表示媒體已就緒,不代表廣告正在投放。影片存取取決於帳戶資格;請使用回傳的失敗代碼。bing_get_write_schema:固定的 Microsoft 原生實體欄位。請閱讀每個多型物件的文件以取得其 REST Type 值。結構描述描述 API;帳戶資格仍屬另一回事。bing_health_check:讀取所選帳戶並確認沙箱/生產環境、客戶和貨幣。這不會驗證每個功能。bing_import_video(write):從您可直接下載的 HTTPS 檔案將影片匯入所選帳戶。Microsoft 會非同步擷取和轉碼來源;回傳的 ID 不代表已就緒。請先預覽,然後輪詢 bing_get_videos。不會建立或啟用廣告。bing_list_ad_creatives:擷取與帳戶所屬廣告和 Performance Max 資產群組關聯的實際圖片表示,保留父項 ID/名稱。庫存有限;不推斷投放、影片內容或 KPI 歸因。bing_update_ad(write):使用原生欄位更新一個 Microsoft Ads 廣告。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_update_ad_group(write):使用原生欄位更新一個 Microsoft Ads 廣告群組。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_update_ad_group_targeting(write):更新一個原生廣告群組指定條件。編輯前請先讀取目前的指定設定;使用 Targets 進行人口統計/地理編輯,使用 Audience 進行受眾關聯。不會清除未指定的條件。bing_update_audience(write):使用原生欄位更新一個 Microsoft Ads 受眾。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_update_campaign(write):使用原生欄位更新一個 Microsoft Ads 廣告活動。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_update_campaign_targeting(write):更新一個原生廣告活動指定條件。編輯前請先讀取目前的指定設定;使用 Targets 進行人口統計/地理編輯,使用 Audience 進行受眾關聯。不會清除未指定的條件。bing_update_keyword(write):使用原生欄位更新一個 Microsoft Ads 關鍵字。預設會先預覽。廣告實體會以暫停狀態建立。請先讀取 bing_get_write_schema 和目前的設定。bing_update_video(write):更新帳戶所屬影片資產的描述。不會改變投放或取代影片來源。預設會先預覽;使用 bing_get_videos 回讀。bing_upload_image(write):將圖片位元組上傳至所選的 Microsoft Ads 媒體庫。不會建立或啟用廣告。本機預覽會回報位元組長度,但不會重複圖片主體。
Snapchat Ads(41 個工具,21 個寫入)
適用於已授權、已選取的帳戶。
snapchat_create_ad(write):建立 Snapchat 廣告。一律為 PAUSED。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_adsquad(write):建立 Snapchat 廣告群組。一律為 PAUSED。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_campaign(write):建立 Snapchat 廣告活動。一律為 PAUSED。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_creative(write):建立 Snapchat 創意素材。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_creative_element(write):建立 Snapchat 創意元素。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_interaction_zone(write):建立 Snapchat 互動區域。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_lead_generation_form(write):建立 Snapchat 潛在客戶開發表單。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_lookalike(write):從自有客戶名單種子建立類似受眾。供應商資格與足夠的種子規模仍適用;建立不保證 targetable_status 為 READY。除非 confirm true,否則預覽。snapchat_create_media(write):建立 Snapchat 媒體。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_create_segment(write):建立 Snapchat 區隔。預設為本機預覽;在驗證父項/帳戶擁有權後,確認實際寫入。snapchat_finalize_media_upload(write):在所有部分成功後完成影片上傳。使用 init_media_upload 傳回的確切 finalize_path 與 upload_id。除非 confirm true,否則預覽。snapchat_get_ads:列出所選帳戶中的 Snapchat 廣告,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_adsquads:列出所選帳戶中的 Snapchat 廣告群組,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_campaigns:列出所選帳戶中的 Snapchat 廣告活動,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_creative_elements:列出所選帳戶中的 Snapchat 創意元素,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_creatives:列出所選帳戶中的 Snapchat 創意素材,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_entity:讀取廣告活動、廣告群組、廣告、創意素材、媒體或區隔,並驗證帳戶擁有權。snapchat_get_insights:讀取原生 Snapchat 統計資料,包含明確時間間隔(結束時間不含)、粒度與可選實體細分。花費與貨幣轉換值為微貨幣。空測試帳戶結果不構成實際成效證據。snapchat_get_interaction_zones:列出所選帳戶中的 Snapchat 互動區域,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_lead_generation_forms:列出所選帳戶中的 Snapchat 潛在客戶開發表單,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_media:列出所選帳戶中的 Snapchat 媒體,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_mobile_apps:在建立應用程式推廣廣告活動或行動裝置再行銷受眾前,讀取與所選廣告帳戶關聯的 Snap App ID。snapchat_get_pixels:在設定轉換最佳化或網站受眾前,讀取與所選帳戶關聯的像素。snapchat_get_segments:列出所選帳戶中的 Snapchat 區隔,保留完整的原生設定與分頁。廣告群組即廣告組/廣告集。snapchat_get_setup_guide:讀取 Snapchat 廣告活動目標、受眾工作流程、創意格式先決條件與明確限制。實作不代表帳戶資格或實際投放。在宣稱所有功能皆可用前使用。snapchat_get_targeting:讀取已設定的廣告群組鎖定、受眾、排除條件、人口統計、地理與版位。缺少欄位表示未知,而非廣泛鎖定的證明。成效細分描述投放,而非已設定的鎖定。snapchat_get_targeting_options:在編輯前探索原生鎖定值:國家、地區、語言、性別、興趣與裝置。保留分頁;不要臆造類別 ID。snapchat_get_targeting_specs:讀取分開儲存的鎖定規格,包括超過 500 個條件的設定。這些可能從一般廣告群組回應中省略。snapchat_get_write_schema:探索已實作的 Snapchat 建立/編輯欄位、必填欄位與預覽規則。這些是連接器支援的欄位,而非完整的 Snap API 結構。snapchat_health_check:讀取所選 Snapchat 帳戶、權限可見的中繼資料與測試旗標。測試帳戶無法投放廣告。snapchat_init_media_upload(write):初始化分段影片上傳,最多 256 MiB,最多 32 個部分,每個 8 MiB。傳回 upload_id、add_path 與 finalize_path 供後續呼叫使用。除非 confirm true,否則預覽。snapchat_list_ad_creatives:解析廣告關聯的 Snapchat 圖片/影片、Story 子項目與 Collection 圖塊,包含商家名稱、原生 ID 與最新媒體 URL。不完整格式/媒體會回報。不推斷任何成效。snapchat_update_ad(write):更新 Snapchat 廣告設定,包括名稱。預設為預覽;套用前檢查擁有權。snapchat_update_adsquad(write):更新 Snapchat 廣告群組設定,包括名稱、鎖定、排程與預算。預設為預覽;套用前檢查擁有權。snapchat_update_audience_users(write):新增或移除客戶名單成員。僅接受正規化的 SHA-256 雜湊:EMAIL_SHA256、PHONE_SHA256、MOBILE_AD_ID_SHA256。電子郵件正規化為去除空白/轉小寫;電話為國碼數字;行動 ID 小寫並保留連字號。絕不臆造客戶資料。預覽傳回計數,而非雜湊。呼叫者每請求最多批次 10,000 筆;confirm true 才套用。snapchat_update_campaign(write):更新 Snapchat 廣告活動設定,包括名稱。預設為預覽;套用前檢查擁有權。snapchat_update_creative(write):更新 Snapchat 創意素材設定,包括名稱。預設為預覽;套用前檢查擁有權。snapchat_update_segment(write):重新命名或編輯受眾區隔的保留/描述。未變更的欄位會保留。除非 confirm true,否則為本機預覽。snapchat_update_status(write):暫停或啟用廣告活動、廣告群組或廣告。預設為預覽;啟用生產實體可能花費預算。snapchat_upload_media(write):上傳 base64 圖片/影片位元組至先前建立的媒體物件。解碼後最大 10 MiB。不支援外部 URL 擷取。預覽不傳送位元組;confirm true 在擁有權驗證後上傳。snapchat_upload_media_part(write):上傳一個影片部分,解碼後最多 8 MiB。使用 init_media_upload 傳回的確切 add_path 與 upload_id。預覽絕不傳送位元組。
Meta Ads(57 個工具,23 個寫入)
適用於已授權、已選取的帳戶。
meta_batch_catalog_items(寫入):依 retailer_id 建立或更新最多 50 個目錄產品。回傳非同步批次處理代碼;接受不代表完成。不支援刪除或自動更新。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_create_ad(寫入):使用所選帳戶中現有的廣告組合與素材建立已暫停的廣告。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_create_adcreative(寫入):從現有貼文或明確的 object_story_spec 及選用的 asset_feed_spec 建立廣告素材。支援圖片、影片、輪播、精選集與彈性規格。不會啟動廣告。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_create_adset(寫入):以明確的目標設定、最佳化、版位、歸因、出價與排程建立已暫停的 Meta 廣告組合。金額使用主要帳戶貨幣單位。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_create_campaign(寫入):建立 Meta 廣告活動。一律以已暫停狀態建立,且無法選擇以啟用狀態建立。預設為預覽。meta_create_custom_audience(寫入):建立網站、互動、客戶名單容器或類似廣告受眾。不會上傳客戶資料。條款與資格由 Meta 強制執行。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_create_product_set(寫入):在與所選廣告帳戶相同 Business 所擁有的目錄中建立篩選產品集。絕不會發布至 Shops。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_debug_token:檢查目前存取權杖的有效性、到期時間與授權範圍。適用於診斷驗證問題。meta_duplicate_adset(寫入):在所選帳戶內複製已知良好的廣告組合,保留複雜的原生設定。一律為已暫停狀態且不複製廣告。之後使用 meta_rename_adset 重新命名。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_get_account_details:取得特定 Meta 廣告帳戶的詳細資訊:名稱、貨幣、時區、花費上限、狀態、Business 資訊。meta_get_ad_activity:從 /{ad_account_id}/activities 讀取廣告帳戶活動紀錄,包含 object、event、actor、timestamp 與 extra_data 欄位。meta_get_ad_studies:列出廣告帳戶的轉換提升研究與 A/B 測試(Ad Studies)。包含研究類型、狀態與實驗組。meta_get_ads:列出 Meta 廣告帳戶的廣告,可依廣告組合篩選。回傳廣告 ID、名稱、狀態與素材參考。meta_get_adset_configuration:在準備編輯前讀取現有廣告組合、其上層廣告活動的預算/目標與帳戶貨幣。回傳原生設定;不進行變更。meta_get_adsets:列出 Meta 廣告帳戶的廣告組合,可依廣告活動篩選。回傳目標設定、預算、最佳化與排程資訊。meta_get_audience_details:在權限允許下,讀取詳細的自訂、已儲存與類似廣告受眾,支援分頁與豐富欄位。meta_get_audiences:列出 Meta 廣告帳戶的自訂、已儲存與類似廣告受眾。meta_get_brand_safety_controls:從廣告帳戶/廣告組合的目標設定與選用的封鎖清單邊緣,讀取品牌安全、合適性、版位與內容控制訊號。meta_get_business_assets:以唯讀方式探索可存取的 Meta Business 資產:businesses、pages、Instagram 帳戶、像素與資料集(在權限允許下)。meta_get_campaign_structure:取得階層式廣告活動結構:廣告活動 -> 廣告組合 -> 廣告。有助於了解帳戶組織。meta_get_campaigns:列出 Meta 廣告帳戶的廣告活動。回傳廣告活動 ID、名稱、狀態、目標、預算與出價策略。meta_get_catalog_batch_status:讀取目錄批次處理代碼的完成狀態與逐項錯誤。批次被接受不代表每個產品都成功。meta_get_catalog_products:在目錄存取可用時,讀取 Product Catalogs 與 Product Items。回傳可進行關聯的產品中繼資料,而不建立或更新目錄資產。meta_get_creative_assets:回傳與廣告連結的創意媒體,包含實際廣告名稱、精選集封面、所有輪播/彈性元件、解析後的圖片雜湊與影片 URL。僅目錄廣告會另行分類;如需視覺畫廊,請使用 get_creative_gallery。原始創意中繼資料仍可用於診斷。meta_get_creatives:取得廣告素材內容:文字、圖片、影片、連結、行動呼籲。回傳指定廣告的素材詳細資料。meta_get_delivery_diagnostics:彙總跨廣告活動、廣告組合與廣告的唯讀投放診斷,使用 status/effective_status/issues_info(若可用)加上簡單的投放洞察。meta_get_insights:查詢 Meta Ads 成效洞察。支援 170+ 項指標、43+ 種拆解,並具備智慧查詢規劃。 使用 meta://metrics 資源查看可用指標。使用 meta://breakdowns 查看可用拆解。 查詢規劃器會自動將不相容的指標/拆解組合拆分為多個 API 請求,並合併結果。meta_get_instagram_accounts:在權限允許下,列出與可存取 Pages、Business Manager 資產或廣告帳戶連結的 Instagram 帳戶。meta_get_organic_content_enrichment:讀取 Facebook Page 貼文與 Instagram 媒體,包含 URL、原生期間與選用洞察。這些是內容洞察,而非 Ads Insights;請勿推斷僅限自然觸及的拆解。meta_get_page_posts:使用從已連結使用者解析的 Page token 讀取已發布的 Facebook Page 貼文。回傳確切的 PageID_PostID、訊息、永久連結與媒體附件。使用 postId 進行精確的現有貼文廣告預檢。不會請求 Instagram 媒體、留言、按讚或洞察;此單獨讀取不構成廣告投放資格。meta_get_pages:列出可存取的 Facebook Pages,包含 id、name、category、tasks、picture,以及可用的已連結 Instagram 帳戶參考。meta_get_pixels:在可存取時,從廣告帳戶或 Business Manager 列出像素與資料集,並針對權限受限的邊緣回傳可操作的警告。meta_get_study_results:取得轉換提升或 A/B 測試研究的詳細結果。回傳目標、實驗組與提升結果。meta_get_video_sources:為特定廣告影片解析最新的下載 URL(source)與縮圖。請在下載時呼叫:回傳的 URL 已簽署且會快速過期。meta_health_check:適合代理程式的唯讀健康檢查:驗證 token 中繼資料、列出可存取的廣告帳戶,並在未暴露存取權杖的情況下警告缺少的讀取範圍。meta_interpret_experiment_results:讀取並解讀 A/B 測試或轉換提升研究結果,包含信心防護、實驗組、目標與選用的實驗組實體。meta_join_product_insights:查詢產品拆解洞察,並在目錄存取可用時,以 Product Catalog 中繼資料豐富資料列。meta_list_ad_accounts:列出目前 token 可存取的所有 Meta 廣告帳戶。回傳帳戶 ID、名稱、貨幣、時區與狀態。meta_list_ad_images:列出廣告帳戶的圖片庫(/adimages):hash、名稱、尺寸、狀態、永久公開的顯示 URL(permalink_url)、短期 CDN URL,以及選用使用每張圖片的素材。meta_list_ad_videos:列出廣告帳戶的影片庫(/advideos):標題、持續時間、處理狀態與公開提供的縮圖(偏好與最大尺寸)。來源檔案 URL 僅在要求時回傳,因為它們會快速過期。meta_rename_ad(寫入):重新命名 Meta 廣告。僅變更名稱。預設為預覽。meta_rename_adset(寫入):重新命名 Meta 廣告組合。僅變更名稱。預設為預覽。meta_rename_campaign(寫入):重新命名 Meta 廣告活動。僅變更名稱。預設為預覽。meta_search_entities:在廣告帳戶內依名稱搜尋廣告活動、廣告組合或廣告。有助於尋找特定實體。meta_update_ad_creative(寫入):將廣告的素材替換為同一帳戶中的另一個現有素材。廣告狀態不變。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_update_ad_status(寫入):暫停或重新啟用 Meta 廣告。預設為預覽:若無 confirm: true,工具僅描述變更而不套用。meta_update_adset_budget(寫入):變更 Meta 廣告組合的每日或長期預算。金額以帳戶貨幣為單位(12.50 代表 12.50 EUR)。Meta 預期使用小單位,此處會進行換算。預設為預覽。meta_update_adset_configuration(寫入):更新目標設定、最佳化、版位、歸因、出價、預算或排程。目標設定是「完整取代」,而非部分合併。狀態不變。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_update_adset_schedule(寫入):變更 Meta 廣告組合的開始或結束時間。時間為 ISO 8601 格式並包含時區偏移,例如 2026-09-01T00:00:00+0200。預設為預覽。meta_update_adset_status(寫入):暫停或重新啟用 Meta 廣告組合。預設為預覽:若無 confirm: true,工具僅描述變更而不套用。meta_update_campaign_budget(寫入):變更在廣告活動層級持有預算的 Meta 廣告活動預算(Advantage 廣告活動預算)。若廣告活動沒有此預算,Meta 會拒絕,此時應變更廣告組合預算。金額以帳戶貨幣為單位。預設為預覽。meta_update_campaign_status(寫入):暫停或重新啟用 Meta 廣告活動。預設為預覽:若無 confirm: true,工具僅描述變更而不套用。meta_update_custom_audience(寫入):更新現有自訂廣告受眾的名稱、描述、保留期或完整規則。不會直接變更廣告受眾成員資格。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_update_product_set(寫入):取代產品集的篩選器或重新命名。寫入前會檢查目錄所有權與集合成員資格。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_upload_ad_image(寫入):使用 base64 位元組(解碼後最多 5 MiB)將圖片上傳至所選廣告帳戶。預覽僅回報大小,絕不會顯示檔案內容。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_upload_ad_video(寫入):從可公開存取的 HTTPS URL 或 base64 MP4 位元組(解碼後最多 5 MiB)匯入影片。Meta 會非同步處理。不會啟動任何廣告活動。預設為本機預覽。無自動重試。在 Meta 驗證或變更前會先檢查帳戶所有權。meta_validate_query:在執行前驗證指標/拆解組合。回傳錯誤與警告。使用此功能檢查您的查詢是否可行。
Pinterest Ads(52 個工具,24 個寫入)
適用於已授權、已選取的帳戶。
pinterest_batch_catalog_items(write):提交原生 CREATE/UPDATE/UPSERT/DELETE 目錄項目操作。回報完成前,請輪詢回傳的批次 ID。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_ad(write):從可存取的 Pin 建立 PAUSED 廣告。原生規格支援 Pinterest 創意格式,惟須符合資格。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_adgroup(write):建立 PAUSED 廣告群組,並明確指定原生出價、目標設定、預算與排程。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_board(write):在所選廣告主環境中建立 /boards。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_campaign(write):建立 PAUSED 廣告活動。貨幣便利欄位使用帳戶貨幣。廣告活動預算最佳化預設為 true;非 CBO 資格因帳戶而異。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_catalog(write):在所選廣告主環境中建立 /catalogs。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_catalog_feed(write):在所選廣告主環境中建立 /catalogs/feeds。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_pin(write):在所選廣告主環境中建立 /pins。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_product_group(write):在所選廣告主環境中建立 /catalogs/product_groups。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_create_product_group_promotion(write):從目錄產品群組建立 PAUSED 購物或收藏促銷活動。在 Sandbox 中無法使用。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_estimate_delivery:執行非變更性的 Pinterest 規劃計算:廣告群組目標對象規模、出價下限或廣告活動投遞估算。請求主體遵循所選的 Pinterest v5 結構描述,且不會建立或變更任何廣告活動或廣告群組。pinterest_get_account_entities:讀取 Pinterest 廣告帳戶實體與設定。涵蓋帳戶、廣告活動、廣告群組、廣告、產品群組促銷、促銷、標籤、排程、目標範本與訂單明細庫存。回傳一個 API 頁面及其書籤,以利可預測的即時查詢。pinterest_get_audience_insights:讀取彙總的 Pinterest 目標對象洞察,對象為廣告主的總目標對象或互動目標對象、Pinterest 的總目標對象,或範圍/類型端點。Pinterest 固定目標對象洞察的觀察時間窗;這不是自訂日期範圍報表。pinterest_get_audiences:讀取目標對象、客戶名單、分享及企業接收的目標對象庫存,而不上傳或變更目標對象成員資格。pinterest_get_billing_and_orders:讀取帳單設定檔/發票、發票下載 URL、訂單明細、廣告抵免額折扣,以及 SSIO 帳戶/訂單狀態。僅當權杖具有帳戶存取權時,才會回傳財務資料。pinterest_get_business_assets:讀取 Pinterest Business Access 庫存:雇主/關聯企業、資產、成員、合作夥伴、已指派資產、已接收目標對象及邀請。需要相應的企業管理權限。pinterest_get_catalog_diagnostics:讀取深度目錄庫存與診斷:目錄、資訊提供、資訊提供處理結果、項目問題、產品群組、產品數量/產品、可用的篩選值,以及目錄項目查詢。ITEMS 是唯讀的 POST 查詢。pinterest_get_catalog_inventory:列出 Pinterest 目錄庫存表面:目錄、產品群組、產品群組促銷,以及選用的產品樣本。pinterest_get_conversion_setup:檢查 Pinterest 轉換衡量設定:轉換標籤、符合 oCPM 資格/頁面瀏覽標籤、事件品質分數、廣告主定義事件,以及轉換刪除請求狀態。這絕不會傳送或刪除轉換事件。pinterest_get_creative_assets:在可用時擷取 Pinterest 創意資產與期間成效。回傳廣告、Pin、縮圖/圖片/影片、廣告活動/廣告群組情境、目錄訊號及資產分類。pinterest_get_delivery_metrics:讀取 Pinterest 資源/delivery_metrics。使用此項目檢查 Pinterest 官方投遞指標中繼資料,以用於同步或非同步報表。pinterest_get_keyword_intelligence:讀取已指派的目標關鍵字、Pinterest 國家/地區層級關鍵字指標、建議字詞或相關字詞。國家/地區指標每個請求最多接受 2,000 個關鍵字。pinterest_get_lead_assets:讀取潛在客戶表單定義與潛在客戶訂閱設定。刻意排除潛在客戶記錄匯出,因為其可能包含終端使用者的 PII。pinterest_get_organic_inventory:讀取與廣告一同使用的 Pinterest 自然內容:Pin、看板、看板上的 Pin、Pin 產品標籤或搜尋結果。這是庫存中繼資料,並非付費投遞的證明。pinterest_get_pin_analytics:讀取付費 Pin 分析、自然多/單 Pin 分析、使用者帳戶分析、熱門 Pin 或熱門影片 Pin。傳入所選 Pinterest 端點支援的原始指標名稱。pinterest_get_platform_resources:讀取 Pinterest 平台中繼資料與就緒資源:支援的廣告帳戶國家/地區、投遞指標定義、指標就緒度、潛在客戶表單問題、媒體上傳中繼資料、商業整合中繼資料,或已驗證的使用者帳戶。pinterest_get_targeting_options:讀取 Pinterest 官方目標選項目錄,涵蓋應用程式類型、性別、語言、年齡、地點/地理、興趣、關鍵字或目標對象。也可解析特定興趣 ID。pinterest_get_trends:讀取 Pinterest Trends:依支援地區劃分的熱門成長/每月/每年/季節性關鍵字、成長中的產品類別、產品類別詳細資料、精選主題或編輯文章。pinterest_get_write_schema:在撰寫寫入操作前,讀取官方 Pinterest v5 原生請求結構描述與 Sandbox 限制。pinterest_health_check:唯讀的 Pinterest Ads 健康狀態檢查。驗證已設定的憑證、帳戶存取權、投遞指標存取權,以及選用的預設帳戶可讀性,而不會暴露 OAuth 權杖。pinterest_list_ad_accounts:列出已設定憑證可存取的 Pinterest 廣告帳戶。pinterest_list_ad_creatives:列出廣告帳戶在所有狀態下的廣告創意(API 除非被要求,否則會靜默省略 ARCHIVED 廣告),並解析其 Pin 媒體:公開的 i.pinimg.com 圖片 URL(最高 1200px)、影片封面,以及當應用程式獲准讀取時的 video_url。目錄驅動格式預設排除。pinterest_register_media(write):註冊媒體上傳;回傳的 upload_url/參數並非影片已上傳或就緒的確認。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_run_catalog_report:依 PRODUCT_GROUP 或 PRODUCT_ITEM 執行 Pinterest 目錄報表。PRODUCT_ITEM 歷史記錄限制為今天(UTC)前 92 天,請求會分成 31 天視窗;較舊的項目成效無法透過重試取得。如需較舊的目錄投遞總計,請使用 PRODUCT_GROUP,而非個別 SKU 成效。pinterest_run_conversion_product_report:透過 reports/brand_category_sku,依品牌、類別、品牌+類別、SKU 或 SKU 群組執行 Pinterest 非同步轉換產品報表。這是 Pinterest 的受限功能:僅具備 Standard API 存取權並不能保證用戶端可使用。這與 PRODUCT_ITEM 花費報表不同。pinterest_run_report:執行唯讀的 Pinterest Ads 報表。自動將舊版/寬版或明確的非同步請求路由至 Pinterest 非同步報表。使用原始的 Pinterest 報表欄位名稱。pinterest_run_specialized_export:啟動或檢查非變更性的 Pinterest 資料工作,用於行銷組合模型(MMM)、大量廣告主實體下載或目錄診斷。START 僅建立報表/匯出成品;絕不會更新投遞實體。pinterest_run_targeting_report:針對廣告帳戶、廣告活動、廣告群組或廣告執行即時目標分析,並依年齡、性別、地點、興趣、關鍵字、目標對象、版位、裝置或其他 Pinterest 目標類型進行細分。若資料早於同步視窗,請使用 pinterest_run_report 並搭配 targetingTypes 與 executionMode=async。pinterest_update_ad(write):更新原生廣告設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_ad_status(write):更新現有廣告的狀態。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_adgroup_budget(write):以主要帳戶貨幣單位設定恰好一個每日或終身廣告群組預算。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_adgroup_configuration(write):更新原生廣告群組設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_adgroup_status(write):更新現有廣告群組的狀態。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_board(write):在所選廣告主環境中更新 /boards。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_campaign_budget(write):以主要帳戶貨幣單位設定恰好一個每日或終身廣告活動預算。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_campaign_configuration(write):更新原生廣告活動設定。請先讀取現有實體;巢狀規格可能會取代現有值。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_campaign_status(write):更新現有廣告活動的狀態。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_catalog_feed(write):在所選廣告主環境中更新 /catalogs/feeds。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_pin(write):更新 Pin。除了 pins:write 之外,還需要 Pinterest 受限的 pin_edit 權限;僅具備 Standard 權限不足。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_product_group(write):在所選廣告主環境中更新 /catalogs/product_groups。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_update_product_group_promotion(write):更新目錄產品群組促銷。在 Sandbox 中無法使用。預設為預覽模式。不自動重試變更操作。原生 API 資格與權限範圍仍適用。pinterest_validate_report:驗證並預覽 Pinterest 報表將如何執行。回傳同步/非同步路由、端點、層級、欄位、歸因設定與警告,而不呼叫成效端點。
Google Ads(44 個工具,10 個寫入)
適用於已授權、已選取的帳戶。
google_ads_apply_plan(write):預覽、驗證並以原子方式套用 Google Ads v25 的建置/變更計畫:廣告活動、預算、廣告群組、RSA/多媒體/Demand Gen 廣告、圖片/文字/YouTube 資產、PMax 資產群組與連結、關鍵字、地理/語言指定目標清單群組,以及轉換動作設定(不包含轉換事件上傳)。使用原生 REST camelCase 欄位;金額以明確指定貨幣的整數微單位表示。支援暫時性負數資源 ID,以便在單一交易中依序建立。不支援 VIDEO 廣告活動建立(Google API 限制)、帳單、帳戶存取變更、客戶名單或轉換上傳。新的廣告活動/廣告群組/廣告一律為 PAUSED 狀態。先在不帶 confirm 的情況下呼叫以檢查計畫並取得 planHash;validateOnly 會要求 Google 驗證但不套用;執行時需要 confirm 及相符的 expectedPlanHash。使用 google_ads_run_gaql 回讀結果。在不確定的網路結果後,切勿在檢查其名稱/ID 之前重試建立作業。google_ads_create_campaign(write):建立 Google Ads 廣告活動。一律以 PAUSED 狀態建立,且無法選擇以啟用狀態建立:必須有人先檢視後才能開始花費。同時會建立廣告活動預算。預設為預覽模式。google_ads_generate_ad_group_themes:將提供的關鍵字整理到現有的 Google Ads 廣告群組中。傳回建議的廣告群組/廣告活動配對、正規化的關鍵字文字,以及建議的比對類型,但不會建立或編輯關鍵字。唯讀的 Keyword Planner RPC。google_ads_generate_keyword_forecast_metrics:預測臨時關鍵字廣告活動的曝光次數、點擊次數、CTR、CPC、成本、轉換次數和 CPA。支援指定目標、排除關鍵字、比對類型、三種出價策略、明確的未來日期,以及可選的每個關鍵字獨立明細。此唯讀且無計畫的 RPC 不會建立廣告活動或儲存計畫。google_ads_generate_keyword_historical_metrics:取得所提供關鍵字的 Keyword Planner 搜尋量歷史資料。傳回平均每月搜尋次數、每月量(最多 48 個月)、最新量、計算出的 3 個月及年增率變化、競爭程度、CPC/出價範圍、近似變體,以及可選的裝置總計。此為唯讀且無計畫的 RPC。google_ads_generate_keyword_ideas:從最多 20 個種子關鍵字、一個 URL、關鍵字加 URL,或整個網站發掘 Keyword Planner 靈感。傳回歷史量、每月趨勢、計算出的 3 個月/年增率變化、競爭程度、出價、近似變體、可選的概念,以及分頁。唯讀;不會儲存計畫。google_ads_get_account_details:取得特定 Google Ads 客戶帳戶的詳細資訊。google_ads_get_account_hierarchy:從 GAQL customer_client 列出可存取的客戶,並在可能的情況下列出管理員/客戶關係。若階層查詢不可用,則改為回退到可存取的客戶。google_ads_get_adgroups:列出 Google Ads 帳戶的廣告群組,可選擇依廣告活動篩選。google_ads_get_bidding_strategies:列出投資組合出價策略。僅在提供 startDate/endDate 時包含指標;否則僅傳回結構。google_ads_get_budgets:列出廣告活動預算,包含金額、狀態、放送方式和建議預算欄位(若支援)。google_ads_get_campaigns:列出 Google Ads 帳戶的廣告活動,包含狀態、預算、管道類型和出價策略。google_ads_get_change_events:擷取最近的 change_event 列。強制執行 Google Ads 限制:日期範圍須在最近 30 天內,且 LIMIT <= 10000。google_ads_get_conversion_actions:列出轉換動作,包含狀態、類型、類別、主要/納入轉換旗標、擁有者客戶,以及最近活動日期(若支援)。google_ads_get_demand_gen_assets:列出 Demand Gen 廣告(影片回應式、多資產、輪播),並解析其引用的創意素材:穩定的圖片 URL 和 YouTube 影片 ID,附嵌入和縮圖 URL。補足涵蓋 Performance Max 的 google_ads_get_pmax_assets。google_ads_get_insights:以智慧查詢規劃查詢 Google Ads 成效洞察。自動產生 GAQL,並透過分割查詢處理指標/維度不相容的情況。 使用 google-ads://metrics 取得可用指標,使用 google-ads://dimensions 取得維度。google_ads_get_keyword_performance:從 keyword_view 資源取得關鍵字層級成效資料。顯示品質分數、曝光次數、點擊次數、成本。google_ads_get_landing_pages:擷取 landing_page_view 成效,包含最終 URL、廣告活動/廣告群組情境、流量、轉換,以及到達網頁品質指標(若支援)。google_ads_get_paid_organic_search_terms:唯讀的付費/自然搜尋字詞報表。在可用時使用 paid_organic_search_term_view,若自然欄位不可用則回退到僅付費的 search_term_view。google_ads_get_pmax_asset_diagnostics:唯讀的 Performance Max 資產群組診斷。傳回廣告強度、資產涵蓋範圍行動項目、主要狀態原因、可選的成效指標,以及可選的頂尖資產組合。google_ads_get_pmax_assets:從 asset_group_asset 列出 Performance Max 資產群組資產,包含資產群組/廣告活動情境,以及可選的日期範圍成效指標。google_ads_get_pmax_placements:從 performance_max_placement_view 取得唯讀的 Performance Max 版位診斷。傳回版位類型、顯示名稱、目標 URL、廣告活動情境,以及僅曝光次數。google_ads_get_recommendations:列出 Google Ads 建議,包含類型、資源、廣告活動/廣告群組連結、已關閉狀態,以及影響(若支援)。google_ads_get_search_terms:根據 reportType 從 search_term_view 或 campaign_search_term_insight 擷取搜尋字詞成效。google_ads_get_shopping_performance:唯讀的 Shopping 成效報表,以 Merchant Center 產品維度為鍵。適合將花費/轉換與商家 ID、商品 ID、標題、品牌、動態饋給標籤和自訂標籤進行關聯。google_ads_get_shopping_products:透過 shopping_product 取得唯讀的 Merchant Center 產品目錄/資格報表。支援帳戶、廣告活動和廣告群組範圍,並在帳戶有 Shopping/PMax 電子商務資料時包含成效指標。google_ads_get_simulations:唯讀的規劃/預測查詢,用於廣告活動、廣告群組或投資組合出價模擬。在可用時傳回模擬中繼資料和預測點清單,並提供中繼資料回退。google_ads_health_check:唯讀的連線檢查。驗證憑證是否存在、Google Ads API 存取權、登入客戶可見性、API 版本,以及可操作的警告,且不會洩漏機密。google_ads_list_accounts:列出目前憑證可存取的 Google Ads 客戶帳戶。若可存取的客戶是管理員帳戶,也會嘗試從 customer_client 納入已啟用的子帳戶。google_ads_list_image_assets:列出帳戶的圖片資產庫(FROM asset),包含 tpc.googlesyndication.com 上穩定、公開提供服務的完整尺寸 URL、尺寸、檔案大小和 MIME 類型。這是完整的素材庫,不包含放送概念:2022 年上傳且從未放送的資產,看起來與目前正在執行的資產完全相同。最新的排在最前面,因此 limit 會傳回近期資產而非任意區段,回應中的計數是帳戶總數。若只要以視覺方式檢視資產並依日期查看放送,請使用 get_creative_gallery(涵蓋 Performance Max)。僅在需要 KPI 卡片時才要求 get_creative_performance。Shopping 產品圖片位於 Merchant Center,不在這個素材庫中。google_ads_list_video_assets:列出帳戶的 YouTube 影片資產(FROM asset),包含衍生的觀看、嵌入和公開縮圖 URL。這是完整的素材庫,不包含放送概念:多年前上傳且從未放送的資產,看起來與目前正在執行的資產完全相同。最新的排在最前面,因此 limit 會傳回近期資產而非任意區段,回應中的計數是帳戶總數。若只要以視覺方式檢視資產並依日期查看放送,請使用 get_creative_gallery(涵蓋 Performance Max)。僅在需要 KPI 卡片時才要求 get_creative_performance。Google Ads 不提供可下載的影片檔案:PMax 和 Demand Gen 影片託管在 YouTube 上,因此請透過嵌入或縮圖顯示。google_ads_remove_video_upload(write):移除所選廣告帳戶擁有的影片上傳。會刪除上傳的 YouTube 影片,並可能中斷引用它的廣告。需要預覽及相符的 expectedPlanHash。Google v25 將標題/說明標記為不可變;此工具不會假裝編輯它們。google_ads_rename_campaign(write):重新命名 Google Ads 廣告活動。只有名稱會變更:放送、預算和指定目標皆不受影響。預設為預覽模式。google_ads_run_gaql:執行原始 GAQL(Google Ads 查詢語言)查詢。可完全彈性滿足任何報表需求。 範例:SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100。google_ads_run_readonly_rpc:進階唯讀逃生門,用於 GAQL 之外的允許清單 Google Ads 服務:Audience Insights、Reach Planner、基準、創作者/熱門洞察、指定目標建議、Smart Campaign 建議、身分驗證、發票和付款帳戶。操作是列舉;任意路徑和所有變更/上傳皆不可能。google_ads_search_fields:搜尋 Google 的即時 GoogleAdsField 目錄。發掘每個可查詢的 GAQL 資源、屬性、區隔、指標、列舉值,以及可與之一起選取的相容性關係。唯讀,且在原始 GAQL 查詢前很有用。google_ads_suggest_geo_targets:將最多 25 個位置名稱或地理目標 ID 解析為 Google Ads geoTargetConstants。傳回條件 ID、正式名稱、目標類型、狀態、上層、地區設定和約略觸及人數。唯讀。google_ads_update_adgroup_bid(write):變更 Google Ads 廣告群組的預設 CPC 出價。金額以帳戶貨幣為單位(1.20 代表 1.20 EUR)。對使用自動出價策略的廣告活動沒有影響。預設為預覽模式。google_ads_update_adgroup_status(write):暫停、重新啟用或移除 Google Ads 廣告群組。預設為預覽模式。google_ads_update_campaign_budget(write):變更 Google Ads 廣告活動的每日預算。金額以帳戶貨幣為單位(12.50 代表 12.50 EUR)。預設為預覽模式。google_ads_update_campaign_schedule(write):變更 Google Ads 廣告活動的開始或結束日期。日期為帳戶時區的 YYYY-MM-DD 格式。預設為預覽模式。google_ads_update_campaign_status(write):暫停、重新啟用或移除 Google Ads 廣告活動。預設為預覽模式:若未使用 confirm: true,工具會描述變更但不套用。google_ads_upload_video(write):將 MP4/WebM/QuickTime 位元組(最大 16 MiB)上傳到所選廣告帳戶的 Google 管理 YouTube 頻道。可見性為 UNLISTED:任何擁有連結的人皆可檢視,並非私人。預設預覽會省略位元組並傳回 planHash;confirm 需要 expectedPlanHash。此 API 沒有 validateOnly。上傳後,使用 google_ads_run_gaql 查詢 you_tube_video_upload.state 和 video_id;僅在 PROCESSED 之後,透過 google_ads_apply_plan assetOperation.youtubeVideoAsset 使用影片 ID。不確定的上傳後不會自動重試。google_ads_validate_query:在執行查詢之前驗證指標/維度/資源相容性。檢查區隔限制和資源可用性。
TikTok Ads(60 個工具,27 個寫入)
適用於已授權、已選取的帳戶。
tiktok_create_adgroup(write):建立已停用的經典 TikTok 廣告群組。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_create_ads(write):建立已停用的經典 TikTok 廣告(影片、圖片、輪播或授權的 Spark 內容)。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_create_campaign(write):建立 TikTok 廣告活動。一律以已停用狀態建立,且無法選擇以執行中狀態建立。預設為預覽。tiktok_create_campaign_advanced(write):建立已停用的經典 TikTok 廣告活動。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_ad(write):建立已停用的升級版 Smart+ TikTok 廣告(影片、圖片、輪播或授權的 Spark 內容)。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_adgroup(write):建立已停用的升級版 Smart+ TikTok 廣告群組。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_create_smart_plus_campaign(write):建立已停用的升級版 Smart+ TikTok 廣告活動。無法選擇啟動為啟用狀態。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_get_adgroups:讀取完整的原生廣告群組設定,包括目標設定、自訂/類似受眾參考與排除條件、地理、語言、年齡/性別、版位、興趣/行為、預算與排程。設定 smartPlus:true 以使用升級版 Smart+ 的 targeting_spec。遺漏的欄位視為未知,而非不受限制的目標設定。分頁。tiktok_get_ads:列出 TikTok 廣告主的廣告。回傳廣告 ID、名稱、操作狀態與創意資訊。tiktok_get_advertiser_info:取得特定 TikTok 廣告主帳戶的詳細資訊:貨幣、時區、狀態、餘額。tiktok_get_asset_urls:重新解析特定 TikTok 媒體庫資產(file/video/ad/info 與 file/image/ad/info)的全新、可公開擷取 URL。請在顯示或下載時呼叫:每個 TikTok 媒體 URL 都有簽章且有有效期限。tiktok_get_async_report_status:在非同步報告端點可用時,依 taskId 檢查 TikTok 非同步報告任務狀態。不會建立或變更任何報告。tiktok_get_audience_details:在 TikTok DMP 端點可存取時,取得自訂/類似/已儲存受眾的詳細資料。僅限唯讀。tiktok_get_audience_overlap:唯讀的受眾重疊診斷,涵蓋廣告群組、自訂受眾、已儲存受眾與目標設定欄位。tiktok_get_audience_report:依年齡或性別讀取 TikTok AUDIENCE 成效報告,層級涵蓋廣告主、廣告活動、廣告群組或廣告,包括來自符合資格的 Smart+ 廣告活動的投放資料。多個人口統計會回傳個別報告,而非聯合分布。明確的分頁與原生供應商錯誤;不會推斷已設定的目標設定或自訂受眾成員資格。tiktok_get_audiences:列出 TikTok 廣告主帳戶的自訂與類似受眾。tiktok_get_campaigns:列出 TikTok 廣告主帳戶的廣告活動。回傳廣告活動 ID、名稱、狀態、預算與目標。tiktok_get_creative_fatigue_recipes:從廣告層級的每日報告找出可能的創意疲勞模式,並回傳唯讀的更新建議配方。不會建立、編輯或上傳創意素材。tiktok_get_creatives:取得 TikTok 廣告主帳戶中特定廣告的創意詳細資料(影片、圖片、文字)。tiktok_get_delivery_status:彙總廣告活動、廣告群組與廣告的投放狀態/operation_status,並提供簡單診斷。tiktok_get_entities_raw:列出 TikTok 廣告活動、廣告群組或廣告,可選擇呼叫端選取的原生欄位、篩選、排序與分頁。此僅限 GET 的逃生門可存取新發布的實體欄位,無需等待 MCP 的策展 schema。tiktok_get_events:探索廣告主的像素/應用程式事件或可存取的追蹤診斷。使用盡力而為的端點檢查,並以報告維度作為備援。tiktok_get_insights:使用目前的原生/計算指標目錄與查詢規劃,查詢 TikTok Ads 成效洞察。 請使用 tiktok://metrics 資源查看可用指標。請使用 tiktok://dimensions 查看維度。 年齡/性別維度會自動透過 tiktok_get_audience_report 路由至 AUDIENCE 報告,包括廣告活動與廣告群組層級。其他維度使用 BASIC 規劃器。多個受眾分解維持個別報告,絕不合併。tiktok_get_pixels:列出 TikTok 像素,並在權限允許時,列出廣告主的像素事件中繼資料。當端點無法使用時,會以明確警告進行備援。tiktok_get_read_endpoint:進階的僅限 GET TikTok Business API 逃生門,用於尚未由專門 MCP 工具建模的已記錄 JSON 讀取端點。相對 v1.3 路徑與 JSON 相容的查詢參數會經過驗證;OAuth、變更、下載與潛在客戶記錄路徑皆被封鎖。tiktok_get_report_raw:執行原生 TikTok BASIC 或 AUDIENCE 同步報告,可選擇呼叫端選取的維度與指標。AUDIENCE 支援人口統計,例如廣告活動/廣告群組層級的年齡/性別;tiktok_get_audience_report 提供引導路徑。當目前 API 欄位尚未出現在 tiktok://metrics 時使用;與 tiktok_get_insights 不同,此工具不會計算別名或自動拆分不相容的選取項目。tiktok_get_search_ads_maturity:從關鍵字/搜尋字詞報告與選用的關鍵字建議端點,診斷 TikTok Search Ads 的成熟度。僅限唯讀診斷。tiktok_get_shop_catalog_diagnostics:唯讀的 TikTok Shop/目錄/電子商務診斷。先嘗試目錄報告,再嘗試 Shop 拍賣指標,並在目錄權限無法使用時回傳端點警告。tiktok_get_spark_ads:在可用時,從廣告欄位回傳 Spark Ads 脈絡,若 Spark 特定欄位不受支援,則提供保守的備援。tiktok_get_spark_organic_joins:在權限允許時,將可存取的 Spark Ads 欄位與付費頁面/貼文報告及選用的自然觸及身分/貼文端點結合。僅限唯讀。tiktok_get_targeting:讀取已設定的廣告群組目標設定與受眾參考:自訂/類似受眾的包含/排除、地理、語言、年齡/性別、版位、興趣與行為。支援經典與升級版 Smart+(smartPlus:true),保留 targeting_spec 與自動目標設定。不會推斷已投放的受眾或隱藏的 Smart+ 訊號。請使用 tiktok_get_audiences 取得受眾名稱/類型,並使用 tiktok_get_audience_report 取得已投放的人口統計。tiktok_get_targeting_catalog:讀取 TikTok 目標設定與規劃目錄:地點、語言、興趣、行為、主題標籤、Search Ads 關鍵字想法/健康度、裝置、電信業者、脈絡標籤、內容排除與時區。tiktok_get_video_assets:在可用時,從 ad/get 與影片素材端點回傳與廣告關聯的 TikTok 影片資產中繼資料。tiktok_get_write_context:在編輯或建立新設定前,讀取確切的 TikTok 實體、上層設定與廣告主貨幣/時區。僅限唯讀。tiktok_health_check:TikTok 憑證、可存取的廣告主與廣告主資訊的唯讀健康檢查。絕不回傳權杖或機密。tiktok_list_ad_images:列出廣告主的完整圖片媒體庫(file/image/ad/search):檔案名稱、尺寸、簽章、輪播可用性,以及公開提供的圖片 URL,簽章有效期約三十天(image_url_expires_at 提供確切時間點)。tiktok_list_ad_videos:列出廣告主的完整影片媒體庫(file/video/ad/search):檔案名稱、持續時間、尺寸、簽章,以及公開提供的預覽與封面 URL。每個 TikTok URL 都有簽章,且約六小時後到期:使用前請以 tiktok_get_asset_urls 重新解析。tiktok_list_advertisers:列出目前權杖可存取的所有 TikTok 廣告主帳戶。回傳廣告主 ID、名稱與狀態。tiktok_rename_ad(write):重新命名一個經典 TikTok 廣告。不會變更其預算、創意內容或狀態。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_rename_adgroup(write):重新命名一個經典 TikTok 廣告群組。不會變更其預算、創意內容或狀態。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_rename_campaign(write):重新命名一個經典 TikTok 廣告活動。不會變更其預算、創意內容或狀態。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_search_keywords:取得 TikTok Search Ads 的關鍵字建議。回傳含搜尋量估算的建議關鍵字。tiktok_update_ad_status(write):暫停或重新啟用剛好一個經典廣告。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_adgroup_budget(write):變更 TikTok 廣告群組的預算。金額以帳戶貨幣計,原樣送出。預設為預覽。tiktok_update_adgroup_configuration(write):更新經典 TikTok 廣告群組。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_adgroup_status(write):暫停或重新啟用 TikTok 廣告群組。預設為預覽。tiktok_update_ads(write):更新經典 TikTok 廣告(影片、圖片、輪播或授權的 Spark 內容)。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_campaign_budget(write):變更 TikTok 廣告活動預算,以帳戶貨幣計。預設為預覽。tiktok_update_campaign_configuration(write):更新經典 TikTok 廣告活動。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_campaign_status(write):暫停或重新啟用 TikTok 廣告活動。預設為預覽。tiktok_update_smart_plus_ad(write):更新升級版 Smart+ TikTok 廣告(影片、圖片、輪播或授權的 Spark 內容)。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_ad_status(write):暫停或重新啟用剛好一個 Smart+ 廣告。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_adgroup(write):更新升級版 Smart+ TikTok 廣告群組。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_adgroup_status(write):暫停或重新啟用剛好一個 Smart+ 廣告群組。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_campaign(write):更新升級版 Smart+ TikTok 廣告活動。狀態不變。原生目標/格式資格由 TikTok 強制執行。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_campaign_status(write):暫停或重新啟用剛好一個 Smart+ 廣告活動。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_update_smart_plus_material_status(write):暫停或重新啟用一個升級版 Smart+ 廣告內選定的創意素材。上層廣告活動、廣告群組與廣告狀態不變;共享媒體庫資產不會被修改。預設為本機預覽。不自動重試;套用前會檢查廣告主所有權。tiktok_upload_ad_image(write):從公開的 HTTPS 媒體 URL 或 base64 檔案匯入圖片(最大 5 MiB)。TikTok 可能會非同步處理;接受並不代表媒體已就緒。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_upload_ad_video(write):從公開的 HTTPS 媒體 URL 或 base64 檔案匯入影片(最大 5 MiB)。TikTok 可能會非同步處理;接受並不代表媒體已就緒。預設為本機預覽。不會自動重試;套用前會檢查廣告主所有權。tiktok_validate_query:在執行前驗證 TikTok 指標/維度組合。檢查維度分組規則、終身相容性,以及指標/維度相容性。
Search Console(18 個工具,0 個寫入)
適用於已授權且已選取的帳戶。
gsc_analyze_search_appearance_trends:當 GSC 暴露 searchAppearance 維度時,透過 Search Analytics 的 searchAppearance 維度分析結構化資料與豐富結果趨勢訊號。gsc_bulk_inspect_urls:以保守的循序限制檢查多個 URL,並回傳正規化的 URL Inspection 結果。配額:每個資源每天 2000 次請求。gsc_cluster_queries:依簡單 token 與意圖訊號(品牌/非品牌、疑問句、類別與主題 token)將 Search Console 查詢分群。gsc_compare_search_types:比較 Search Console 各搜尋類型(網頁、圖片、影片、新聞、探索與 Google 新聞)的成效。gsc_detect_cannibalization:偵測 Search Analytics 的 query-page 列中,多個頁面競爭點擊/曝光數的查詢。gsc_find_losses_gains:比較兩個期間的查詢或頁面成效,並回傳點擊/曝光/CTR/平均排名的差異。gsc_get_data_freshness:透過查詢最近的每日列,偵測含有 Search Analytics 資料的最新日期。gsc_get_sitemap_health:回傳增強的唯讀 Sitemap 健康狀態摘要,包含狀態總計、已提交/已索引內容計數、警告與錯誤。gsc_health_check:驗證 Google Search Console 唯讀驗證、可見資源、設定的預設網站與權限層級,且不暴露 token。gsc_indexation_watchlist:針對重要 URL 的唯讀 URL Inspection 監看清單。檢查最多 10 個 URL,並回傳警示/審查/正常評估,不儲存狀態。gsc_inspect_url:檢查 URL 的 Google 索引狀態、檢索資訊、行動裝置可用性、AMP 與豐富結果。配額:每個資源每天 2000 次請求。gsc_list_sitemaps:列出已提交至 Search Console 資源的 Sitemap,包含處理狀態與已提交/已索引計數。gsc_list_sites:列出目前憑證可存取的所有 Google Search Console 資源。gsc_monitor_indexation_freshness:唯讀監控快照,涵蓋 Search Analytics 新鮮度、Sitemap 索引總計,以及可選的小型 URL Inspection 樣本。gsc_plan_large_site_sampling:根據 Sitemap 風險訊號與 Search Analytics 頁面成效,為大型網站建立唯讀 URL Inspection 取樣計畫。gsc_query_search_analytics:查詢 Google Search Console Search Analytics。回傳查詢、頁面、國家/地區、裝置、日期與搜尋外觀的點擊數、曝光數、CTR 與平均排名。 使用 gsc://metrics、gsc://dimensions、gsc://filters 與 gsc://compatibility 取得可用欄位與規則。gsc_track_sitemap_deltas:唯讀 Sitemap 差異追蹤器。擷取目前 Sitemap 快照,並與代理程式提供的基準比較;不寫入任何狀態。gsc_validate_query:在執行前驗證 Search Console 的指標/維度/搜尋類型組合。
Google Analytics 4(27 個工具,0 個寫入)
適用於已授權且已選取的帳戶。
ga4_batch_run_pivot_reports:在單一官方 Data API 批次請求中,針對相同資源執行 1-5 個獨立的唯讀 GA4 樞紐分析報表。ga4_batch_run_reports:在單一官方 Data API 批次請求中,針對相同資源執行 1-5 個獨立的唯讀 GA4 核心報表。ga4_check_compatibility:詢問官方 GA4 Data API,哪些維度與指標與建議的核心報表選取相容。ga4_get_audience_diagnostics:唯讀受眾診斷,來源包含 Admin API 受眾、Data API 週期性受眾清單,以及觀察到的 audienceName 報表備援。ga4_get_audience_export_diagnostics:唯讀 Audience Export 診斷。列出現有的受眾匯出、狀態計數,並可選擇從現有匯出中取樣列。ga4_get_bigquery_export_diagnostics:偵測 GA4 BigQuery 匯出連結,並診斷匯出模式、串流涵蓋範圍、排除的事件與資料集位置。ga4_get_channel_groups:列出為 GA4 資源定義的自訂管道群組。ga4_get_custom_definitions:列出 GA4 Data API 中繼資料暴露的自訂維度與自訂指標。自訂定義庫存的唯讀備援。ga4_get_ecommerce_diagnostics:唯讀電子商務涵蓋範圍診斷,涵蓋指定日期範圍內的核心電子商務事件、營收指標與項目層級報表。ga4_get_event_parameters:盡力從 GA4 中繼資料與事件報表建立事件參數庫存。記錄 Data API 對原始參數的限制。ga4_get_key_events:使用具中繼資料感知的 Data API 報表盤點 GA4 關鍵事件/轉換。回傳盡力的事件名稱與計數。ga4_get_metadata:取得特定 GA4 資源可用的完整維度與指標清單。適用於探索自訂維度/指標。ga4_get_property_configuration:讀取 GA4 資源詳細資料,以及選定的單例 Admin 設定(歸因、保留、Google Signals、報表身分或使用者提供的資料設定)。ga4_get_property_quotas_snapshot:從官方 v1alpha 端點讀取目前 GA4 Data API 資源配額快照。這不會執行報表,但 Google 仍會從剩餘配額最多的類別扣除一個資源配額 token。ga4_get_server_side_tagging_diagnostics:盡力從資料串流、Measurement Protocol 密鑰、事件規則與串流設定進行唯讀伺服器端標記診斷。ga4_health_check:唯讀 GA4 健康狀態檢查。驗證設定的憑證、可存取的資源與中繼資料/資源存取,且不暴露 OAuth token。ga4_list_accounts:列出已驗證使用者可存取的原始 GA4 Analytics Admin 帳戶(唯讀、自動分頁)。ga4_list_admin_resources:以唯讀模式列出允許清單中的 GA4 Admin 集合:串流、自訂定義、關鍵事件、受眾、產品連結、註解、管道群組、擴充資料集、子資源/彙總設定與存取綁定。ga4_list_audience_exports:列出現有的 GA4 Audience Export 快照與週期性受眾清單,不建立新的匯出。ga4_list_properties:列出目前憑證可存取的所有 GA4 資源。回傳資源 ID、顯示名稱、時區與貨幣。ga4_query_audience_export:從現有的 GA4 Audience Export 查詢列。使用者/裝置識別碼預設會遮蔽;僅透過明確選擇加入才包含。ga4_run_advanced_funnel_report:執行 GA4 Data API v1alpha runFunnelReport 端點,可選的 breakdown/next-action,若不可用則備援為唯讀步驟計數。ga4_run_funnel_recipe:使用每個 eventName/pagePath 步驟一個 GA4 報表執行唯讀可設定漏斗配方,並回傳簡單的步驟計數。ga4_run_pivot_report:執行唯讀 GA4 Data API 樞紐分析報表,包含原生篩選器、排序、配額狀態、多個日期範圍,以及最多 250,000 個樞紐分析儲存格。每個樞紐分析都需要明確的限制。ga4_run_realtime_report:執行唯讀 GA4 Data API 即時報表。即時報表僅支援有限的維度與指標子集。ga4_run_report:執行具智慧查詢規劃的 GA4 分析報表。支援 52 個指標、63 個維度、自動分頁。 使用 ga4://metrics 與 ga4://dimensions 資源取得可用欄位。每個請求最多 9 個維度 + 10 個指標。ga4_validate_query:在執行前驗證指標/維度組合。檢查最大限制(9 個維度、10 個指標)、電子商務規則與維度相容性。