概览
Google 搜索结果是用户了解品牌、产品、事件和行业话题时最常接触的信息入口。这份数据把一个关键词对应的公开搜索内容整理成可分析的明细,每条记录带有标题、摘要、页面链接、结果类型、展示排名和采集时间,也保留广告、AI 概览、相关问题、相关搜索与站内链接等增强内容。
它适合成为品牌可见度、搜索竞争格局和内容选题判断的原始底表。相比人工逐页查看,结构化结果可以直接用于排序、分组、筛选和跨期比较,更容易发现哪些页面持续占据前列、哪些主题正在形成新的内容机会。
数据说明
数据来自 Google 公开搜索页面,覆盖自然结果以及页面实际展示的广告、AI 概览、相关问题、相关搜索和站内链接信息。记录按搜索页码与展示排名反映采集时的页面顺序,同一结果链接只保留一条。标题、摘要、展示网址、评分和价格等内容均以搜索页面当时展示的原始文本为准,其中价格不补充币种或单位,时间字段也不推断文档未注明的时区。不同结果类型可用字段不同,例如自然结果通常有标题、摘要和链接,相关问题或 AI 概览可能只填充对应的专属字段。只覆盖无需登录即可看到并可被公开采集的内容,受地区、语言、个性化展示或页面变化影响的结果可能与人工查看时不同。
结果长什么样
每条记录代表一个带稳定页面链接的搜索结果:
| 搜索关键词 | 结果标题 | 结果摘要 | 结果链接 | 结果类型 | 结果排名 |
|---|---|---|---|---|---|
| cartier | Cartier | Movement, fluidity, and color: the new Clash de Cartier creations amplify this distinctive jewelry collection. | https://www.cartier.com/en-us/home | organic | 1 |
| cartier | Bracelets - Cartier | Explore Cartier bracelet collections and signature jewelry creations. | https://www.cartier.com/en-us/jewelry/bracelets/ | organic | 2 |
记录中还可能包含采集时间、搜索地区、界面语言、广告信息、相关问题和站内链接等字段。
应用场景
- 做品牌搜索可见度分析时,按「搜索关键词」汇总「结果类型」和「结果排名」,观察品牌官网、媒体与竞品页面各自占据的位置。
- 做内容差距研究时,结合「结果标题」「结果摘要」和「相关问题」,归纳高频主题与用户关注点,形成选题清单。
- 做搜索结果变化追踪时,按「结果链接」比对不同采集时间的「结果排名」,识别新进入、退出或明显升降的页面。
- 做搜索资产盘点时,联看「AI 摘要」「广告标题」「站内标题一」和「相关搜索词」,区分不同展示模块中的品牌触点。
适用边界
单次调用提交一个关键词,最多聚合 100 页、每页 100 条,共 10000 条;仅覆盖公开可采集的 Google 搜索结果。
- 适合用于
- 需要按关键词批量获取 Google 搜索结果及自然排名时
- 需要同时观察广告、AI 摘要、相关问题和站内链接等搜索增强内容时
- 不要用于
- 需要即时返回少量搜索结果时——该 App 采用后台采集任务
- 需要登录后内容、非公开页面或网页正文全文时——结果仅覆盖公开搜索展示信息
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空结果时,先缩短关键词或移除日期、地区、语言和站点限制后重试
- 2限流、服务暂不可用或请求超时可稍后重试;鉴权失败需先检查执行环境中的凭证配置
- 3任务失败或过期后可原样重新提交;部分成功时会保留已经采集到的结果
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| keyword | 搜索关键词 | string | 是 | — | — | cartier | 要采集的 Google 搜索关键词,最多 512 个字符 |
| all_these_words | 必须包含的词 | string | 否 | — | — | — | 结果中必须同时出现的词,多个词用空格分隔;不填则不发送该条件 |
| any_of_these_words | 任意包含的词 | string | 否 | — | — | — | 结果中至少出现一个的候选词,多个词用空格分隔;不填则不发送该条件 |
| crawl_num | 采集数量 | integer | 否 | — | 1– | — | 期望采集的结果数量;不填则不发送该条件,值越大耗时和费用可能越高 |
| end_date | 结束日期 | string | 否 | — | — | — | 日期范围的结束日期,格式为 YYYY-MM-DD;不填则不发送该条件 |
| file_type | 文件类型 | string | 否 | — | — | — | 只保留指定文件类型的结果,例如 Adobe Acrobat PDF (.pdf);不填则不发送该条件 |
| interface_language | 界面语言 | string | 否 | — | — | — | Google 搜索界面使用的语言,例如 English;不填则不发送该条件 |
| last_update | 最后更新时间 | string | 否 | — | — | — | 按最后更新时间筛选的取值,例如 w;不填则不发送该条件 |
| none_of_these_words | 排除词 | string | 否 | — | — | — | 结果中不能出现的词,多个词用空格分隔;不填则不发送该条件 |
| numbers_ranging_from | 数字范围 | string | 否 | — | — | — | 限定结果中的数字范围,例如 2024..2026;不填则不发送该条件 |
| order_type | 搜索类型 | string | 否 | — | — | — | 搜索类型取值,例如 ALL;不填则不发送该条件 |
| pagination_times | 翻页次数 | string | 否 | — | — | — | 搜索结果采集的翻页次数,使用正整数字符串;不填则不发送该条件 |
| region | 搜索地区 | string | 否 | — | — | — | 限制搜索结果所属地区,例如 United States;不填则不发送该条件 |
| results_per_page | 每页结果数 | string | 否 | — | — | — | Google 搜索页面期望展示的结果数,使用正整数字符串;不填则不发送该条件 |
| search_language | 搜索结果语言 | string | 否 | — | — | — | 限制搜索结果使用的语言,例如 English;不填则不发送该条件 |
| site_or_domain | 站点或域名 | string | 否 | — | — | — | 只搜索指定站点或域名,例如 pf.kakao.com;不填则不发送该条件 |
| start_date | 开始日期 | string | 否 | — | — | — | 日期范围的开始日期,格式为 YYYY-MM-DD;不填则不发送该条件 |
| terms_appearing | 关键词位置 | string | 否 | — | — | — | 限定关键词在页面中的出现位置,例如 anywhere in the page;不填则不发送该条件 |
| this_exact_word_or_phrase | 精确短语 | string | 否 | — | — | — | 结果中必须完整出现的词或短语;不填则不发送该条件 |
| usage_rights | 使用权限 | string | 否 | — | — | — | 按内容使用权限过滤,例如 not filtered by license;不填则不发送该条件 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| aio_content | AI 摘要 | string | — | 搜索结果中的 AI 概览正文 |
| aio_source_title | AI 来源标题 | string | — | AI 概览引用来源的标题 |
| aio_source_title_description | AI 来源说明 | string | — | AI 概览引用来源的摘要说明 |
| aio_source_title_url | AI 来源链接 | string | — | AI 概览引用来源的页面链接 |
| all_these_words | 必须词 | string | — | 本次搜索要求必须同时出现的词 |
| any_of_these_words | 任意词 | string | — | 本次搜索要求至少出现一个的候选词 |
| average_rating | 平均评分 | string | — | 搜索结果展示的平均评分原始文本 |
| biz_id | 业务标识 | string | — | 搜索结果记录携带的业务标识 |
| clean_update_time | 清洗更新时间 | string | — | 记录完成清洗更新的时间 |
| crawl_time | 采集时间 | string | — | 搜索结果被采集的时间 |
| current_page | 结果页码 | string | — | 该结果在 Google 搜索中的页码原始值 |
| detail_url | 结果链接 | string | — | 搜索结果指向的稳定唯一页面链接 |
| displayed_url | 展示网址 | string | — | 搜索结果页面展示的网址或站点名称 |
| end_date | 结束日期 | string | — | 本次搜索使用的日期范围结束值 |
| file_type | 文件类型 | string | — | 本次搜索使用的文件类型限制 |
| has_next_page | 是否有后页 | string | — | Google 搜索结果是否还有下一页的原始文本 |
| interface_language | 界面语言 | string | — | 本次搜索使用的 Google 界面语言 |
| keyword | 搜索关键词 | string | — | 产生该条记录的搜索关键词 |
| last_update | 更新时间筛选 | string | — | 本次搜索使用的最后更新时间条件 |
| none_of_these_words | 排除词 | string | — | 本次搜索要求排除的词 |
| numbers_ranging_from | 数字范围 | string | — | 本次搜索使用的数字范围条件 |
| order_type | 搜索类型 | string | — | 本次搜索使用的搜索类型 |
| pagination_times | 翻页次数 | string | — | 本次搜索设置的 Google 结果翻页次数 |
| paid_product_price | 广告价格 | string | — | 付费商品结果展示的价格原始文本 |
| paid_product_provider | 广告提供方 | string | — | 付费商品结果的提供方 |
| paid_product_title | 广告标题 | string | — | 付费商品结果的标题 |
| paid_title_url | 广告链接 | string | — | 付费结果标题指向的页面链接 |
| partition_day | 数据日期 | string | — | 搜索结果记录所属的数据日期 |
| people_also_ask_answer | 相关问题答案 | string | — | 其他用户还会问模块中的答案 |
| people_also_ask_date | 问题日期 | string | — | 相关问题内容展示的日期 |
| people_also_ask_question | 相关问题 | string | — | 其他用户还会问模块中的问题 |
| people_also_ask_title | 问题来源标题 | string | — | 相关问题答案来源页面的标题 |
| people_also_ask_url | 问题来源链接 | string | — | 相关问题答案来源页面的链接 |
| rating_count | 评分数量 | string | — | 搜索结果展示的评分数量原始文本 |
| region | 搜索地区 | string | — | 本次搜索使用的地区限制 |
| related_queries_title | 相关搜索词 | string | — | Google 展示的相关搜索词 |
| related_queries_url | 相关搜索链接 | string | — | 相关搜索词对应的搜索链接 |
| result_description | 结果摘要 | string | — | 搜索结果展示的摘要文本 |
| result_position | 结果排名 | string | — | 搜索结果展示的排名原始值 |
| result_title | 结果标题 | string | — | 搜索结果展示的页面标题 |
| result_type | 结果类型 | string | — | 搜索结果的类型,例如自然结果或付费结果 |
| results_per_page | 每页结果数 | string | — | 本次搜索设置的每页结果数原始值 |
| search_language | 搜索语言 | string | — | 本次搜索使用的结果语言限制 |
| site_link_title_1 | 站内标题一 | string | — | 搜索结果第一个站内链接的标题 |
| site_link_title_2 | 站内标题二 | string | — | 搜索结果第二个站内链接的标题 |
| site_link_title_3 | 站内标题三 | string | — | 搜索结果第三个站内链接的标题 |
| site_link_title_4 | 站内标题四 | string | — | 搜索结果第四个站内链接的标题 |
| site_link_url_1 | 站内链接一 | string | — | 搜索结果第一个站内链接的地址 |
| site_link_url_2 | 站内链接二 | string | — | 搜索结果第二个站内链接的地址 |
| site_link_url_3 | 站内链接三 | string | — | 搜索结果第三个站内链接的地址 |
| site_link_url_4 | 站内链接四 | string | — | 搜索结果第四个站内链接的地址 |
| site_or_domain | 限定站点 | string | — | 本次搜索使用的站点或域名限制 |
| sr_updated_time | 结果更新时间 | string | — | 搜索结果记录的最终更新时间 |
| start_date | 开始日期 | string | — | 本次搜索使用的日期范围开始值 |
| task_item | 任务关键词 | string | — | 任务元信息中关联的搜索关键词 |
| task_no_data | 是否无数据 | boolean | — | 任务元信息是否标记该关键词没有结果 |
| terms_appearing | 关键词位置 | string | — | 本次搜索使用的关键词出现位置条件 |
| this_exact_word_or_phrase | 精确短语 | string | — | 本次搜索要求完整出现的词或短语 |
| usage_rights | 使用权限 | string | — | 本次搜索使用的内容使用权限条件 |
| view_count | 浏览数量 | string | — | 搜索结果展示的浏览数量原始文本 |
记录 Schema
输出按记录逐条返回。记录主键为 detail_url,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"aio_content": {
"type": "string",
"title": "AI 摘要",
"description": "搜索结果中的 AI 概览正文"
},
"aio_source_title": {
"type": "string",
"title": "AI 来源标题",
"description": "AI 概览引用来源的标题"
},
"aio_source_title_description": {
"type": "string",
"title": "AI 来源说明",
"description": "AI 概览引用来源的摘要说明"
},
"aio_source_title_url": {
"type": "string",
"title": "AI 来源链接",
"description": "AI 概览引用来源的页面链接"
},
"all_these_words": {
"type": "string",
"title": "必须词",
"description": "本次搜索要求必须同时出现的词"
},
"any_of_these_words": {
"type": "string",
"title": "任意词",
"description": "本次搜索要求至少出现一个的候选词"
},
"average_rating": {
"type": "string",
"title": "平均评分",
"description": "搜索结果展示的平均评分原始文本"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "搜索结果记录携带的业务标识"
},
"clean_update_time": {
"type": "string",
"title": "清洗更新时间",
"description": "记录完成清洗更新的时间"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "搜索结果被采集的时间"
},
"current_page": {
"type": "string",
"title": "结果页码",
"description": "该结果在 Google 搜索中的页码原始值"
},
"detail_url": {
"type": "string",
"title": "结果链接",
"description": "搜索结果指向的稳定唯一页面链接"
},
"displayed_url": {
"type": "string",
"title": "展示网址",
"description": "搜索结果页面展示的网址或站点名称"
},
"end_date": {
"type": "string",
"title": "结束日期",
"description": "本次搜索使用的日期范围结束值"
},
"file_type": {
"type": "string",
"title": "文件类型",
"description": "本次搜索使用的文件类型限制"
},
"has_next_page": {
"type": "string",
"title": "是否有后页",
"description": "Google 搜索结果是否还有下一页的原始文本"
},
"interface_language": {
"type": "string",
"title": "界面语言",
"description": "本次搜索使用的 Google 界面语言"
},
"keyword": {
"type": "string",
"title": "搜索关键词",
"description": "产生该条记录的搜索关键词"
},
"last_update": {
"type": "string",
"title": "更新时间筛选",
"description": "本次搜索使用的最后更新时间条件"
},
"none_of_these_words": {
"type": "string",
"title": "排除词",
"description": "本次搜索要求排除的词"
},
"numbers_ranging_from": {
"type": "string",
"title": "数字范围",
"description": "本次搜索使用的数字范围条件"
},
"order_type": {
"type": "string",
"title": "搜索类型",
"description": "本次搜索使用的搜索类型"
},
"pagination_times": {
"type": "string",
"title": "翻页次数",
"description": "本次搜索设置的 Google 结果翻页次数"
},
"paid_product_price": {
"type": "string",
"title": "广告价格",
"description": "付费商品结果展示的价格原始文本"
},
"paid_product_provider": {
"type": "string",
"title": "广告提供方",
"description": "付费商品结果的提供方"
},
"paid_product_title": {
"type": "string",
"title": "广告标题",
"description": "付费商品结果的标题"
},
"paid_title_url": {
"type": "string",
"title": "广告链接",
"description": "付费结果标题指向的页面链接"
},
"partition_day": {
"type": "string",
"title": "数据日期",
"description": "搜索结果记录所属的数据日期"
},
"people_also_ask_answer": {
"type": "string",
"title": "相关问题答案",
"description": "其他用户还会问模块中的答案"
},
"people_also_ask_date": {
"type": "string",
"title": "问题日期",
"description": "相关问题内容展示的日期"
},
"people_also_ask_question": {
"type": "string",
"title": "相关问题",
"description": "其他用户还会问模块中的问题"
},
"people_also_ask_title": {
"type": "string",
"title": "问题来源标题",
"description": "相关问题答案来源页面的标题"
},
"people_also_ask_url": {
"type": "string",
"title": "问题来源链接",
"description": "相关问题答案来源页面的链接"
},
"rating_count": {
"type": "string",
"title": "评分数量",
"description": "搜索结果展示的评分数量原始文本"
},
"region": {
"type": "string",
"title": "搜索地区",
"description": "本次搜索使用的地区限制"
},
"related_queries_title": {
"type": "string",
"title": "相关搜索词",
"description": "Google 展示的相关搜索词"
},
"related_queries_url": {
"type": "string",
"title": "相关搜索链接",
"description": "相关搜索词对应的搜索链接"
},
"result_description": {
"type": "string",
"title": "结果摘要",
"description": "搜索结果展示的摘要文本"
},
"result_position": {
"type": "string",
"title": "结果排名",
"description": "搜索结果展示的排名原始值"
},
"result_title": {
"type": "string",
"title": "结果标题",
"description": "搜索结果展示的页面标题"
},
"result_type": {
"type": "string",
"title": "结果类型",
"description": "搜索结果的类型,例如自然结果或付费结果"
},
"results_per_page": {
"type": "string",
"title": "每页结果数",
"description": "本次搜索设置的每页结果数原始值"
},
"search_language": {
"type": "string",
"title": "搜索语言",
"description": "本次搜索使用的结果语言限制"
},
"site_link_title_1": {
"type": "string",
"title": "站内标题一",
"description": "搜索结果第一个站内链接的标题"
},
"site_link_title_2": {
"type": "string",
"title": "站内标题二",
"description": "搜索结果第二个站内链接的标题"
},
"site_link_title_3": {
"type": "string",
"title": "站内标题三",
"description": "搜索结果第三个站内链接的标题"
},
"site_link_title_4": {
"type": "string",
"title": "站内标题四",
"description": "搜索结果第四个站内链接的标题"
},
"site_link_url_1": {
"type": "string",
"title": "站内链接一",
"description": "搜索结果第一个站内链接的地址"
},
"site_link_url_2": {
"type": "string",
"title": "站内链接二",
"description": "搜索结果第二个站内链接的地址"
},
"site_link_url_3": {
"type": "string",
"title": "站内链接三",
"description": "搜索结果第三个站内链接的地址"
},
"site_link_url_4": {
"type": "string",
"title": "站内链接四",
"description": "搜索结果第四个站内链接的地址"
},
"site_or_domain": {
"type": "string",
"title": "限定站点",
"description": "本次搜索使用的站点或域名限制"
},
"sr_updated_time": {
"type": "string",
"title": "结果更新时间",
"description": "搜索结果记录的最终更新时间"
},
"start_date": {
"type": "string",
"title": "开始日期",
"description": "本次搜索使用的日期范围开始值"
},
"task_item": {
"type": "string",
"title": "任务关键词",
"description": "任务元信息中关联的搜索关键词"
},
"task_no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "任务元信息是否标记该关键词没有结果"
},
"terms_appearing": {
"type": "string",
"title": "关键词位置",
"description": "本次搜索使用的关键词出现位置条件"
},
"this_exact_word_or_phrase": {
"type": "string",
"title": "精确短语",
"description": "本次搜索要求完整出现的词或短语"
},
"usage_rights": {
"type": "string",
"title": "使用权限",
"description": "本次搜索使用的内容使用权限条件"
},
"view_count": {
"type": "string",
"title": "浏览数量",
"description": "搜索结果展示的浏览数量原始文本"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"rookieyao__google-search-results": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=rookieyao/google-search-results",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 10 条为一个计费单位,不足 10 条按 10 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。