serp-keyword-research

SERP 与关键词研究

通过 Crawlora API 获取搜索引擎结果样本和关键词／趋势信号，并将其整理为规范化 JSON。Baidu 和 Yandex 提供本地化结果页面；Qwant 和 Startpage 目前仅提供自动补全建议。

何时使用此技能

• “Google / Bing 上 <query> 的排名结果是什么？”／“截取……的 SERP 快照”。
• “……的关键词创意／自动补全建议”（建议端点）。
• “……话题最近有热度吗？”／“……关键词的热度随时间／地区如何变化？”
• “……的相关查询和飙升查询”（Google Trends）。
• SEO／SERP 监控、关键词发现或趋势研究。

一次性设置

• 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需银行卡）。
• 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

1. SERP — Google 搜索使用 POST /google/search，并传入扁平的 keyword、 language 和 country 字段。Bing、Brave、DuckDuckGo、Yahoo、Baidu 和 Yandex 使用带有 q 参数的 GET 请求。搜索结果是各提供商特有的样本： 保留每个搜索引擎的市场／语言设置、结果顺序和获取时间；不要将不同搜索引擎的排名 视为统一的位置指标。遇到 503 挑战时，记录失败情况；只有在符合所请求的市场时， 才使用其他搜索引擎。
2. 垂直搜索 — 各搜索引擎的新闻／视频／图片（/google/news、/bing/videos、 /duckduckgo/news、/duckduckgo/image、/duckduckgo/video、/duckduckgo/shopping 等）。
3. 关键词创意 — 自动补全：GET /google/suggest?q=...、/bing/suggest、 /brave/suggest、/baidu/suggest、/yandex/suggest、/qwant/suggest 和 /startpage/suggest。建议是按来源排序的查询创意，并非搜索量估算，也不能证明受众需求。
4. 趋势 — Google Trends 的 POST 端点： /google/trends/explore/interest-over-time、/interest-by-region、 /related-topics、/rising-queries、/top-queries（请求体：{"keywords":[...]}）， 以及用于查询当前热门内容的 GET /google/trends/trending。

完整端点列表、请求方法和参数：reference/endpoints.md。

调用 API

# GET search engines + suggest:
scripts/crawlora.sh /bing/search q="web scraping api" | jq '.'
scripts/crawlora.sh /brave/search q="web scraping api" | jq '.'
scripts/crawlora.sh /duckduckgo/search q="web scraping api" | jq '.'
scripts/crawlora.sh /yahoo-search/search q="web scraping api" | jq '.'
scripts/crawlora.sh /baidu/search q="web scraping api"
scripts/crawlora.sh /yandex/search q="web scraping api"
scripts/crawlora.sh /google/suggest q="web scraping" | jq '.'
scripts/crawlora.sh /qwant/suggest q="web scraping"
scripts/crawlora.sh /startpage/suggest q="web scraping"

# POST endpoints take a JSON body (note -X POST):
scripts/crawlora.sh -X POST /google/search '{"keyword":"web scraping api","language":"en","country":"us"}' | jq '.'
scripts/crawlora.sh -X POST /google/trends/explore/interest-over-time '{"keywords":["web scraping"]}' | jq '.'

所有请求都使用 scripts/crawlora.sh；该脚本会避免将 API 密钥暴露在命令行参数中。

端点参考

有关此技能使用的所有搜索和建议端点（请求方法、路径、参数和说明），请参阅 reference/endpoints.md。

示例

• SERP 快照： 对目标查询使用 POST /google/search（以及 /bing/search）； 记录排名结果的标题／URL，以跟踪排名随时间的变化。
• 扩展关键词： 种子词 → /google/suggest → 对每条建议调用 POST /google/trends/explore/rising-queries，以发现增长势头。
• 趋势检查： 使用 POST /google/trends/explore/interest-over-time 并传入 {"keywords":["electric bikes","e-bikes"]}，比较各时间序列。

备注与限制

• 额度／成功后计费： 仅对 2xx 响应计费；免费套餐每月 2,000 个额度。 密钥获取地址：https://crawlora.net。
• 仅限公开数据 — 公开搜索结果；请遵守各搜索引擎的条款。
• 搜索结果列表并非完整索引导出。Baidu／Yandex、Qwant／Startpage 和英语内容提供商的区域设置与结果语义各不相同； 请将样本分开保存，不要据此推断普遍排名、流量或需求。
• 安全： 密钥只能存放在 CRAWLORA_API_KEY 中 — 切勿将其硬编码、用作查询参数或提交到代码库。
• 搜索端点在搜索引擎返回挑战页面时可能会响应 503 — 请重试或切换搜索引擎（Google ↔ Bing ↔ Brave）。Google 搜索的速率限制约为 每秒 1 个请求（超出时返回 429）。