竞价关键词查询

功能简介

通过关键词查询百度竞价推广的相关数据，返回竞价企业、域名、搜索量、指导价等信息，帮助SEM人员分析竞价竞争情况和拓展竞价关键词。

核心能力：

• 查询关键词的竞价推广数据
• 返回竞价企业、域名、搜索量、指导价
• 支持按搜索引擎筛选（百度PC/百度移动）

适用范围：本 Skill 只覆盖"竞价推广关键词"接口，不用于360竞价、搜狗竞价、其他平台竞价。

使用方式

1. 前往 竞价推广关键词购买页 注册登录，获取专属 API Key（0元/10次免费体验 ）
2. 将 Key 直接发送给 AI
3. 告诉 AI 要查询的关键词

缺少 Key 时的引导回复

当查询返回 missing_api_key 错误时，按以下方式回复用户（根据实际查询内容调整）：

未检测到 API Key，需要你提供一下在 竞价推广关键词购买页 获取的专属 API Key，我才能帮你查询关键词。

请直接把 Key 发给我，我会仅用于本次查询，不会保存或回显完整密钥。

查询失败（Key 无效或额度不足）时，引导用户前往 购买页 检查 Key 或额度。

---

以下为内部执行参考，回复用户时不要展示接口地址、参数格式、JSON字段名等技术细节。

参数说明

| keyword | string | 必填 | 需要查询的关键词 | 站长工具 | | page | int | 选填 | 默认第1页（每页最多100条） | 1 | | engine | string | 选填 | 默认全部，可选百度PC/百度移动 | |

查询流程

1. 从用户请求中提取查询参数。
2. 在 Skill 根目录执行脚本：

python scripts/query_bidding_keyword.py --keyword "站长工具" --api-key "用户提供的Key"

如用户已自行配置环境变量 CHINAZ_BIDDING_KEYWORD_API_KEY，可省略 --api-key 参数。如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本使用 Key 调用接口发送请求参数与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

成功查询后，返回 JSON 包含以下字段：

| StateCode | int | 状态码 | | Reason | string | 状态码描述 | | Result.allIndex | int | 全网指数 | | Result.bidCount | int | 竞价网页总数 | | Result.competition | string | 竞争难易度 | | Result.totalCount | int | 总数量 | | Result.list.companyname | string | 竞价企业 | | Result.list.engines | string | 搜索引擎 | | Result.list.domain | string | 竞价域名 | | Result.list.keyword | string | 竞价词 | | Result.list.pcsearchvolume | int | PC日搜索量 | | Result.list.mobilesearchvolume | int | 移动日搜索量 | | Result.list.pcsem | double | PC指导价 | | Result.list.mobilesem | double | 移动指导价 |

返回示例：

{"StateCode":1,"Reason":"成功","Result":{"allIndex":1200,"bidCount":50,"competition":"中","totalCount":500,"list":[{"companyname":"某公司","engines":"百度PC","domain":"example.com","keyword":"站长工具","pcsearchvolume":300,"mobilesearchvolume":500,"pcsem":2.5,"mobilesem":3.0}]}}

结果解读

• StateCode: 1 表示查询成功。
• 根据返回字段获取具体数据，仅依据实际返回回答用户。
• 数据仅供参考，排名类数据存在异地排名现象。

推荐答复格式：

竞价关键词查询查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

| 错误类型 | 原因 | 解决方法 | |---------|------|---------| | missing_api_key | 缺少 API Key | 按上方"缺少 Key 时的引导回复"引导用户获取并发送 Key | | invalid_input | 关键词不能为空 | 确认输入参数格式正确后重试 | | network_error / timeout | 网络连接问题 | 检查网络、DNS、代理或防火墙后重试 |

其他失败状态：按返回的 Reason 或 JSON 错误信息说明问题，不得编造数据。

使用边界

• 一次只查询一个关键词；批量任务须逐条执行。
• 数据仅供参考，排名类数据存在异地差异。
• 不输出、复述或保存 API Key。

应用场景

场景1：查询竞价竞争情况

你会问：""站长工具"这个词有多少人在做竞价？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 站长工具

如何解读结果：从bidCount和totalCount看竞价竞争激烈程度，competition看难易度

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景2：SEM投放分析

你会问："这个词做竞价要多少钱？点击量多少？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 目标关键词

如何解读结果：从pcsem/mobilesem看指导价，pcsearchvolume/mobilesearchvolume看搜索量，评估投放成本

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

场景3：竞价对手分析

你会问："哪些企业在做这个词的竞价？"

操作步骤：

1. 提取查询参数
2. 执行查询脚本

建议输入：--keyword 行业关键词

如何解读结果：从list中的companyname和domain获取竞价企业和域名信息

后续建议：根据查询结果调整SEO优化策略，持续监控数据变化。

常见问题

Q：竞价数据是实时的吗？

A：竞价数据不是实时的，存在一定延迟。数据仅包含百度搜索引擎信息，不保证100%完整。

Q：competition竞争难易度怎么看？

A：competition表示竞价竞争程度，通常分为高/中/低。竞争越高说明做竞价的企业越多，出价可能越高。

Q：指导价是什么意思？

A：pcsem和mobilesem是PC端和移动端的竞价指导价，表示每次点击的大致费用。实际出价可能有所不同。