google-ads by jdrhyne/agent-skills
npx skills add https://github.com/jdrhyne/agent-skills --skill google-ads通过 API 或附加的浏览器会话管理 Google Ads 账户。
检查应使用哪种模式:
google-ads.yaml 或设置了 GOOGLE_ADS_* 环境变量# 检查 API 配置
ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null
如果未找到配置,询问:“您有 Google Ads API 凭据吗,还是我应该使用附加的浏览器会话?”
要求: 用户已在浏览器中登录 ads.google.com
browser 工具并指定 profile="chrome"广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
1. 导航至:ads.google.com/aw/campaigns
2. 设置日期范围(右上角的日期选择器)
3. 截取广告系列表格快照
4. 解析:广告系列、状态、预算、成本、转化次数、每次转化费用
1. 导航至:ads.google.com/aw/keywords
2. 点击“添加筛选条件” → 转化次数 → 小于 → 1
3. 点击“添加筛选条件” → 成本 → 大于 → [阈值,例如 $500]
4. 按成本降序排序
5. 截取表格快照以供分析
1. 导航至关键词或广告系列视图
2. 勾选要暂停的项目
3. 点击“编辑”下拉菜单 → “暂停”
4. 确认操作
1. 导航至所需视图(广告系列、关键词等)
2. 点击“下载”图标(表格右上角)
3. 选择格式(推荐 CSV)
4. 文件将下载到用户的“下载”文件夹
有关详细的浏览器选择器: 从此技能的 references 文件夹加载 browser-workflows.md。
要求: Google Ads API 开发者令牌以及本地配置的客户端凭据
# 验证 google-ads SDK
python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"
# 检查配置
cat ~/.google-ads.yaml
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
ga_service = client.get_service("GoogleAdsService")
query = """
SELECT campaign.name, campaign.status,
metrics.cost_micros, metrics.conversions,
metrics.cost_per_conversion
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
"""
response = ga_service.search(customer_id=CUSTOMER_ID, query=query)
query = """
SELECT ad_group_criterion.keyword.text,
campaign.name, metrics.cost_micros
FROM keyword_view
WHERE metrics.conversions = 0
AND metrics.cost_micros > 500000000
AND segments.date DURING LAST_90_DAYS
ORDER BY metrics.cost_micros DESC
"""
operations = []
for keyword_id in keywords_to_pause:
operation = client.get_type("AdGroupCriterionOperation")
operation.update.resource_name = f"customers/{customer_id}/adGroupCriteria/{ad_group_id}~{keyword_id}"
operation.update.status = client.enums.AdGroupCriterionStatusEnum.PAUSED
operations.append(operation)
service.mutate_ad_group_criteria(customer_id=customer_id, operations=operations)
有关完整的 API 参考: 从此技能的 references 文件夹加载 api-setup.md。
适用于任何 Google Ads 账户的快速健康检查:
| 检查项 | 浏览器路径 | 查找内容 |
|---|---|---|
| 零转化关键词 | 关键词 → 筛选条件:转化次数<1,成本>$500 | 浪费的支出 |
| 空广告组 | 广告组 → 筛选条件:广告数量=0 | 没有正在运行的广告创意 |
| 政策违规 | 广告系列 → 状态列 | 黄色警告图标 |
| 优化得分 | 概览页面(右上角) | 低于 70% = 需要采取措施 |
| 转化跟踪 | 工具 → 转化 | 不活跃/无近期数据 |
报告发现时,请使用表格:
## 广告系列效果(最近 30 天)
| 广告系列 | 成本 | 转化次数 | 每次转化费用 | 状态 |
|----------|------|------|-----|--------|
| 品牌词 | $5K | 50 | $100| ✅ 良好 |
| SDK 网页 | $10K | 2 | $5K | ❌ 暂停 |
## 建议操作
1. **暂停**:SDK 网页广告系列(每次转化费用 $5K)
2. **增加**:品牌词预算(表现良好)
google-ads.yaml~/.google-ads.yaml 的权限,切勿在终端输出中回显令牌/密钥。每周安装次数
205
代码仓库
GitHub 星标数
218
首次出现
2026年2月4日
安全审计
安装于
gemini-cli192
opencode192
codex186
cursor182
github-copilot182
kimi-cli172
Manage Google Ads accounts via API or an attached browser session.
Check which mode to use:
google-ads.yaml configured or GOOGLE_ADS_* env vars# Check for API config
ls ~/.google-ads.yaml 2>/dev/null || ls google-ads.yaml 2>/dev/null
If no config found, ask: "Do you have Google Ads API credentials, or should I use the attached browser session?"
Requirements: User logged into ads.google.com in browser
browser tool with profile="chrome"1. Navigate to: ads.google.com/aw/campaigns
2. Set date range (top right date picker)
3. Snapshot the campaigns table
4. Parse: Campaign, Status, Budget, Cost, Conversions, Cost/Conv
1. Navigate to: ads.google.com/aw/keywords
2. Click "Add filter" → Conversions → Less than → 1
3. Click "Add filter" → Cost → Greater than → [threshold, e.g., $500]
4. Sort by Cost descending
5. Snapshot table for analysis
1. Navigate to keywords or campaigns view
2. Check boxes for items to pause
3. Click "Edit" dropdown → "Pause"
4. Confirm action
1. Navigate to desired view (campaigns, keywords, etc.)
2. Click "Download" icon (top right of table)
3. Select format (CSV recommended)
4. File downloads to user's Downloads folder
For detailed browser selectors: Load browser-workflows.md from this skill's references folder.
Requirements: Google Ads API developer token plus locally configured client credentials
# Verify google-ads SDK
python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')"
# Check config
cat ~/.google-ads.yaml
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()
ga_service = client.get_service("GoogleAdsService")
query = """
SELECT campaign.name, campaign.status,
metrics.cost_micros, metrics.conversions,
metrics.cost_per_conversion
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.cost_micros DESC
"""
response = ga_service.search(customer_id=CUSTOMER_ID, query=query)
query = """
SELECT ad_group_criterion.keyword.text,
campaign.name, metrics.cost_micros
FROM keyword_view
WHERE metrics.conversions = 0
AND metrics.cost_micros > 500000000
AND segments.date DURING LAST_90_DAYS
ORDER BY metrics.cost_micros DESC
"""
operations = []
for keyword_id in keywords_to_pause:
operation = client.get_type("AdGroupCriterionOperation")
operation.update.resource_name = f"customers/{customer_id}/adGroupCriteria/{ad_group_id}~{keyword_id}"
operation.update.status = client.enums.AdGroupCriterionStatusEnum.PAUSED
operations.append(operation)
service.mutate_ad_group_criteria(customer_id=customer_id, operations=operations)
For full API reference: Load api-setup.md from this skill's references folder.
Quick health check for any Google Ads account:
| Check | Browser Path | What to Look For |
|---|---|---|
| Zero-conv keywords | Keywords → Filter: Conv<1, Cost>$500 | Wasted spend |
| Empty ad groups | Ad Groups → Filter: Ads=0 | No creative running |
| Policy violations | Campaigns → Status column | Yellow warning icons |
| Optimization Score | Overview page (top right) | Below 70% = action needed |
| Conversion tracking | Tools → Conversions | Inactive/no recent data |
When reporting findings, use tables:
## Campaign Performance (Last 30 Days)
| Campaign | Cost | Conv | CPA | Status |
|----------|------|------|-----|--------|
| Branded | $5K | 50 | $100| ✅ Good |
| SDK Web | $10K | 2 | $5K | ❌ Pause |
## Recommended Actions
1. **PAUSE**: SDK Web campaign ($5K CPA)
2. **INCREASE**: Branded budget (strong performer)
google-ads.yaml~/.google-ads.yaml permissions and never echo tokens/secrets in terminal output.Weekly Installs
205
Repository
GitHub Stars
218
First Seen
Feb 4, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykFail
Installed on
gemini-cli192
opencode192
codex186
cursor182
github-copilot182
kimi-cli172
营销心理学与心智模型应用指南 | 提升营销决策与客户行为理解
39,800 周安装