AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Ads Fetch

skill-ccccchuck-google-ads-agent-skill-ads-fetch · by ccccchuck

从 Google Ads API 获取广告投放数据，支持关键词、广告系列、搜索词等多维度数据。

↗ Repository
— No reviews yet
0 installs
10 views
0.0% view→install

Install

$ agentstack add skill-ccccchuck-google-ads-agent-skill-ads-fetch

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Ads Fetch? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

获取 Google Ads 数据

何时使用

  • 用户想查看广告表现数据
  • 需要指定日期范围的数据
  • 获取关键词、广告系列或搜索词报告

可用脚本

1. 关键词表现

python3 .agents/skills/google-ads/scripts/fetch_keywords.py --date_range TODAY --limit 20

支持的日期范围：TODAY, YESTERDAY, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, THIS_MONTH, LAST_MONTH

输出字段：Campaign, Ad Group, Keyword, Impressions, Clicks, CTR, Conversions, Cost, CPC

2. 广告系列表现

python3 .agents/skills/google-ads/scripts/fetch_campaigns.py --date_range LAST_7_DAYS

输出字段：Campaign Name, Status, Impressions, Clicks, CTR, Conversions, Cost, CPC

3. 搜索词报告

python3 .agents/skills/google-ads/scripts/fetch_search_terms.py --date_range LAST_7_DAYS --limit 30

输出字段：Search Term, Campaign, Ad Group, Match Type, Impressions, Clicks, Conversions, Cost

注意事项

  1. 所有脚本在项目根目录下运行
  2. 数据有 2-3 小时延迟
  3. 费用单位为账户设置的货币；脚本只输出数值，不假设币种
  4. 如果遇到 RefreshError，执行 ads-setup 重新认证
  5. 如果使用者启用了操作记录工作流，每次获取广告系列、关键词或搜索词数据后，建议追加到 ad-ops/operations.md，并在需要后续评估时写入 ad-ops/experiments.jsonl

数据读取记录要求

即使只是查看数据，也要记录为 read_only 或 analyze，避免后续不知道当时参考了哪些数据。

记录至少包含：

  • 日期范围、查询脚本、查询时间、数据延迟说明
  • Campaign 级指标：名称、状态、展示、点击、CTR、花费、转化、CPC、CPA
  • Keyword 级指标：Campaign、Ad Group、Keyword、Match Type、Status、Bid、展示、点击、CTR、花费、转化、CVR、CPC、CPA
  • Search Term 级证据：搜索词、触发关键词、匹配类型、展示、点击、花费、转化、建议动作
  • 若数据将用于改动，保存 baseline 快照到 ad-ops/snapshots/EXP-YYYYMMDD-NNN-baseline.json

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Data & Analytics