SuperAPI AI 工具集

gsc-submit

营销与增长

查看项目

更新于 10-16 06:19

技能介绍

用途:作为 SEO 工程师技能,调用 Google Indexing API 通知 Google 某网址已创建、更新或删除,让 Google 更快发现和抓取页面,而不必等待自然抓取周期。

主要能力: 一、三种输入方式。可直接接受用户给出的网址;可从文件读取,支持 .txt(每行一个网址,以 # 开头的行跳过)、.csv(取第一列为网址)、.xml(sitemap 格式,提取所有 <loc> 值);也可自动扫描项目路由,按框架在 Next.js(app/ 或 pages/)、React Router/Remix、Express/Fastify/Koa(仅 GET 路由)、Astro/Hugo/11ty 等静态站点或 sitemap 中查找路由。 二、提交前默认检查每个网址此前的通知状态,可用 --force 跳过检查,或用 --check 只查询不提交。 三、支持 URL_UPDATED 与 URL_DELETED 两种动作;前者同时用于新页面和已更新页面,后者用于页面被移除(返回 404/410)。

使用方式:先完成 OAuth 配置,所需环境变量为 GSC_CLIENT_ID、GSC_CLIENT_SECRET、GSC_REFRESH_TOKEN,可选 GSC_SITE_URL(用于把相对路径拼成完整网址及路由扫描)。凭据只存放在环境变量中。若已配置 GSC 技能,只需在 Google Cloud Console 启用 Web Search Indexing API 并重新生成包含 indexing 作用域的刷新令牌。域名须在 Google Search Console 中完成所有权验证,且 OAuth 账号须是已验证的所有者。运行命令为: node <skill-path>/scripts/gsc-submit.mjs [options] 常用选项有 --urls、--file、--action、--check、--force,--urls 与 --file 可组合,脚本会自动去重。

限制:Indexing API 默认每日 200 次发布请求配额,超限返回 HTTP 429,配额按太平洋时间每日重置,可在 Google Cloud Console 申请提高;脚本不做客户端限流。提交网址不保证立即被收录,Google 仍会根据内容质量等决定是否及何时收录;不要反复提交同一网址。路由扫描模式会默认排除 API、登录、后台等非公开页面,动态路由(如 [slug])若无实际值会被跳过,且提交前须与用户确认网址列表。