百度流量词挖掘

功能简介

挖掘百度PC和移动端能够带来流量的关键词，返回每个词的搜索量、百度指数、竞价词数、SEM价格等数据，帮助SEO人员选择有价值的关键词进行优化。

核心能力：

• 挖掘能带来流量的百度关键词
• 返回PC和移动端预估流量
• 提供竞价难易度和SEM价格数据

适用范围：本 Skill 只覆盖"百度流量词"接口，不用于其他搜索引擎流量词、关键词排名查询。

快速开始

只需三步即可开始使用：

运行要求

• 支持标准 Agent Skills 的 AI 客户端，且允许执行本地命令。
• Python 3；脚本只使用 Python 标准库，无需安装第三方依赖。
• 能够向 https://openapi.chinaz.net 发起 HTTPS 请求。
• 运行 AI 客户端的环境可读取环境变量。

如果使用的 AI 服务不支持本地命令或环境变量，请改用该服务支持的本地客户端、沙盒密钥管理或安全环境变量注入方式；不要在聊天中发送 API Key。

获取与配置 API Key

第一步：购买接口

在 百度流量词购买页 购买接口并获取专属 API Key。该接口提供 0元/10次 的免费体验额度，适合先试用再决定是否购买付费套餐。

第二步：设置环境变量

将 Key 保存为环境变量，变量名必须是：

CHINAZ_BAIDU_TRAFFIC_KEYWORD_API_KEY

Windows：搜索并打开"编辑账户的环境变量" → 在"用户变量"中新增该变量 → 变量值填入购买后获得的 Key → 确定保存。

macOS / Linux（当前终端会话临时生效）：

export CHINAZ_BAIDU_TRAFFIC_KEYWORD_API_KEY='你的专属APIKey'

如需永久生效，将上述命令添加到 ~/.bashrc 或 ~/.zshrc 中。

第三步：重启生效

重新启动你的 AI 客户端或其运行环境，使新环境变量生效。

安全提醒：不要把真实 Key 写入 SKILL.md、源代码、命令行参数、日志、仓库或聊天记录。若 AI 客户端提供"Secrets""Environment Variables"或"Credentials"配置页，优先使用其安全存储功能。

参数说明

| keyword | string | 必填 | 请输入keyword | 站长工具 | | pageNo | int | 选填 | 默认第1页（每页最多100条） | 1 |

查询流程

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

python scripts/query_baidu_traffic_keyword.py --keyword "站长工具"

如果系统将 Python 3 命令命名为 python3，使用 python3 代替 python。

3. 脚本读取环境变量中的 Key，并调用接口 https://openapi.chinaz.net/v1/1001/baidutrafficwords，发送请求参数与 ChinazVer=1.0 及 APIKey。
4. 从脚本输出的 JSON 读取结果；仅依据实际返回回答用户，不编造数据。

返回字段

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

| code | int | 状态码 | | msg | string | 状态码描述 | | page.pageNo | int | 当前分页 | | page.pageSize | int | 分页返回的数量 | | page.totalCount | int | 总条数 | | page.totalPage | int | 总页数 | | page.list.keyword | string | 长尾词 | | page.list.allIndex | long | 百度指数 | | page.list.bidCount | long | 竞价词数 | | page.list.sem | float | sem价格 | | page.list.pcsearchvolume | long | PC预估流量 | | page.list.mobilesearchvolume | long | 移动预估流量 | | page.list.optimizeLevel | int | 竞价难易度(1困难2一般3简单4空) |

返回示例：

{"code":1,"msg":"成功","page":{"pageNo":1,"pageSize":100,"totalCount":300,"totalPage":3,"list":[{"keyword":"站长工具在线","allIndex":1200,"bidCount":5,"sem":2.5,"pcsearchvolume":300,"mobilesearchvolume":500,"optimizeLevel":2}]}}

结果解读

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

推荐答复格式：

百度流量词挖掘查询结果
- 查询状态：成功 / 失败原因
- 返回数据：按字段展示

错误处理

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

使用边界

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

应用场景

场景1：挖掘流量关键词

你会问："和"站长工具"相关的流量词有哪些？"

操作步骤：

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

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

如何解读结果：从page.list获取流量词列表，每个词包含搜索量、指数等数据

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

场景2：SEO关键词选择

你会问："哪些关键词优化后能带来最多流量？"

操作步骤：

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

建议输入：--keyword 核心关键词

如何解读结果：按pcsearchvolume和mobilesearchvolume排序，选择流量大的词作为优化目标

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

场景3：竞价难易度评估

你会问："这些流量词好不好优化？"

操作步骤：

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

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

如何解读结果：从optimizeLevel判断难易度（1困难/2一般/3简单），选择难度适中的词

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

常见问题

Q：流量词和长尾词有什么区别？

A：流量词是能够带来搜索流量的关键词，搜索量相对较大。长尾词更长更具体，搜索量较小但转化率更高。流量词更适合做流量，长尾词更适合做转化。

Q：optimizeLevel怎么看？

A：optimizeLevel表示竞价难易度：1=困难，2=一般，3=简单，4=空值。数值越大越容易优化。建议选择2-3级的词。

Q：每次返回多少条数据？

A：每页最多返回100条流量词数据，可以通过pageNo参数翻页获取更多。