serpIQ：基于代码库优先的真实 GSC 数据 SEO 审计 CLI

信号 serpIQ · GitHub · 2026 背景 serpIQ 是一款无需安装的 Node.js CLI 工具，通过两项设计约束与传统 SEO 审计平台形成区隔。其一，它在接入任何 SEO 数据之前，优先读取项目的代码库——包括 README、package.json、落地页等——将审计锚定于产品的真实身份，而非泛化的 HTML 爬取。其二，它拉取过去 90 天内真实的 Google Search Console 数据（展示量、点击量、排名），以经过验证的遥测数据取代第三方的关键词估算。LLM 层支持自带密钥（bring-your-own-key）兼容架构：Anthropic、OpenAI、OpenRouter（400+ 模型）、任意 OpenAI 兼容端点，或本地 Ollama 模型。关联 serpIQ 勾勒出一个具体的操作细分领域：AI 智能体在开发者工作流与 SEO 基础设施之间发挥中介作用。其“代码库优先”的设计通过将分析锚定于既有项目构件（而非实时外部页面），有效缩减了大模型幻觉的边界。GSC 的接入使 SEO 审计从估算转向实测。作为原生 npm CLI（npx serpiq），它遵循了“开发者工具优先”的 AI 智能体范式，直接嵌入本地开发工作流。当前状态 安装：npx serpiq audit --gsc-site sc-domain:yoursite.com LLM 提供商：Anthropic、OpenAI、OpenRouter、任意 OpenAI 兼容 API、Ollama 输出结构：.serpiq/ 目录，内含 Markdown 与 JSON 报告、博客简报及 pSEO 模板 审计覆盖范围：健康度评分（0–100）、优先级快速修复项、距首页仅一步之遥的关键词、高展示低点击查询、博客内容规划、程序化 SEO 模板、技术问题、流量衰退页面 GitHub：21 颗星（信号捕获时）开放问题 该工具请求了哪些 GSC API 作用域（scopes），其授权流程为何？当 GSC 历史数据不完整（<60 天）时，该工具如何处理数据时效性？生成的博客简报与 pSEO 模板结构是否足够规范，以支持程序化的 CI/CD 集成？关联 [gptme] —— 终端原生的自主会话工具，支持多提供商 LLM [aider] —— 具备仓库上下文的终端 AI 编程助手 [adminjs] —— 面向 CRUD、数据管理与商业智能的管理后台面板

译注 英文原文中的 "codebase-first" 与 "telemetry" 在此处被译为“代码库优先”与“遥测数据”。中文的“理”（lǐ）本指事物内在的纹理与规律，此处借指代码库作为项目之“理”。审计工具不向外盲目爬取，而是循着既有构件的纹理展开分析，正是“庖丁解牛”式的技术实践：依乎天理，批大郤，导大窾。