技能介绍

要解决什么问题

SEO 和站点运维里，Google Search Console（GSC）里的点击、展示、CTR、排名，以及 URL 是否被索引、站点地图是否提交成功，通常要在控制台里反复点选、导出。若希望 Agent 在对话里直接拉数、做巡检或提交 sitemap，就需要一套稳定、可编排的 API 封装，而不是每次手工登录后台。

技能如何工作

本技能通过 Rube MCP（Composio） 调用 GSC 工具集。使用前需确认 RUBE_SEARCH_TOOLS 可用，并用 RUBE_MANAGE_CONNECTIONS 将 google_search_console 连接为 ACTIVE；且账号在 GSC 中对该属性具备已验证站点或相应权限。工作流上通常先 GOOGLE_SEARCH_CONSOLE_LIST_SITES 列出可访问属性，再按需：

搜索分析：GOOGLE_SEARCH_CONSOLE_SEARCH_ANALYTICS_QUERY，按 date / query / page 等 dimensions 看趋势、热词与页面表现；可用 dimension_filter_groups 聚焦关键词组，或 country、device 做地域与设备拆分。
索引巡检：GOOGLE_SEARCH_CONSOLE_INSPECT_URL 查看指定 URL 的索引状态与问题。
站点地图：GOOGLE_SEARCH_CONSOLE_LIST_SITEMAPS / GOOGLE_SEARCH_CONSOLE_GET_SITEMAP 核对已提交地图；GOOGLE_SEARCH_CONSOLE_SUBMIT_SITEMAP 注册或重新提交。

每次调用前建议先查当前工具 schema（文档见 composio.dev/toolkits/googlesearchconsole）。

适用边界与注意点

站点 URL 格式：URL 前缀属性需带协议与尾部斜杠（如 https://www.example.com/）；域属性用 sc-domain:example.com，格式错误易空结果或报错。
数据延迟与粒度：分析数据通常滞后 2～3 天；data_state: "all" 含较新但可能变动的数据；hourly_all 仅近 3 天内有效。
分页与上限：结果默认按点击降序（按日期分组时按日期升序）；大结果集用 start_row 分页，单次最多约 25,000 行，需收窄日期或加维度过滤。
巡检与提交：inspection_url 必须属于所选 site_url；提交 sitemap 时 feedpath 对应文件须公网可访问且为合法 XML。