First Crawl
中文EN
首页 / Skills
默认本地路线

SEO Skill：本地命令行工具

在本地做有限范围抓取、站点地图健康检查和单页报告，不需要付费 SEO API。

来源已审阅 助手集成未运行 单次 CLI · 合成输入已执行 · 原稿来源核验 2026-10-10
本页目录

它能帮你做什么

只读分析公开网站。从一个页面或最多 10 页的有限抓取开始。不登录、不使用凭据或付费数据服务，不改源码、不对外提交。

预期输出

  • 有限范围的抓取或单页证据，保存为 JSON
  • 实际观察到的响应、元数据和可收录性信号
  • 三个可执行发现，以及仍然未知的事项

环境与准备

上游文档列出的助手：Codex、Claude Code、Cursor、Claude Desktop (MCP)、Other local-stdio MCP clients。

上游文档说明了 Skill/CLI 与 MCP 集成方式。本项目没有安装到任何助手，也没有做运行兼容性测试。

  • Node.js >=22.19.0
  • npm 包 seo，已审阅的源码版本为 0.2.41
  • 命令行模式需要本地 shell 与文件系统；或使用已配置的本地 stdio MCP 客户端
  • 渲染与 Lighthouse 路线可能需要安装浏览器；只做原始 HTTP 抓取不能证明页面渲染结果
  • 运行时依赖包括 undici、robots-parser、linkedom、libsql、lighthouse 和 playwright-core，详见固定版本 package.json

安装前阅读固定版本的 原始 Skill 说明 ↗ 和 环境准备文档 ↗。本站不自动安装。请先查看固定版本及依赖，再按你的环境操作。

费用与权限

Apache-2.0 软件包，本地技术报告没有单独订阅费；现有助手或模型费用仍适用。

商业 API 要求：本地技术抓取、站点地图健康检查和 audit-page 不需要商业 API。Google 登录及付费研究数据服务属于可选能力，不在新手路线中。

使用已提供的公开网址。本练习不运行 seo start、不连接 Google、不添加数据服务、不启用数据补充、不提交 IndexNow，也不购买任何东西。

  • 会直接向目标站点发送 HTTP 请求；浏览器渲染也可能加载第三方页面资源。必须限定主机、页数和深度。
  • 会写入本地缓存、设置和报告文件，不要将这些文件放进公开教学仓库。
  • 按 PRIVACY.md 的说明，默认启用匿名遥测。首次运行 CLI 前设置 DO_NOT_TRACK=1 以退出遥测。
  • 上游 Skill 要求缺少软件包时全局安装未固定版本的 npm 包。不要自动照做，应先审阅并批准固定版本安装。
  • 整套工具还可连接账号、保存令牌、使用付费服务、修改源码和发送 IndexNow 通知，这些都不在本次新手范围内。
  • 宿主 AI 助手可能把工具输出发给模型服务商。本地执行不保证离线处理或全部内容留在设备上。

限定范围的入门任务提示

教学示例 / 原始记录 / 记录模板
请使用已安装的本地 SEO skill 检查 <PUBLIC_URL>。只读操作：不用付费 API，不登录 Google，不接入数据服务，不编辑、不发布、不提交 IndexNow，也不自动安装。设置 DO_NOT_TRACK=1，先核实已安装版本。先查找并了解适合的报告，再构造参数。抓取限制为所给主机内 10 页、深度 1；不检查外链，且关闭此次抓取的站点地图扩展。单页检查使用 audit-page。保存完整 JSON，然后总结三个发现，附证据和限制。遇到身份验证、访问拒绝或范围不清楚时停止。

这是原创教学模板，没有在第三方 Skill 的助手集成中执行。

文档中的 CLI 示例 · 此处未执行

只检查已安装的 CLI 版本。文档示例，未运行。

终端命令 · 此教学命令未在这里执行
DO_NOT_TRACK=1 seo --version

查找并了解单页报告的参数说明。文档示例，未运行。

终端命令 · 此教学命令未在这里执行
DO_NOT_TRACK=1 seo reports describe audit-page --json

阅读已安装版本帮助后，进行有限范围原始抓取。参数来自上游文档；组合示例，未运行。

终端命令 · 此教学命令未在这里执行
DO_NOT_TRACK=1 seo crawl https://example.com --max-pages 10 --max-depth 1 --no-sitemap --no-external --json --output crawl.json

检查已安装版本的帮助，遵守目标站点的访问限制与请求频率限制。本项目不声称成功执行过此命令。

结果能说明什么，不能说明什么

  • 保证收录、排名或流量
  • 根据小范围抓取就声称完成全站审计
  • 根据静态 HTML 证明真实用户的 Core Web Vitals（核心网页指标）
  • 未确认页面用途就自动修改 robots、canonical 或 noindex

来源审阅与实际执行是不同的证据维度。这里不证明搜索引擎收录、排名、流量、安装安全或所有环境的运行兼容性。

有一次独立的本地 CLI 执行记录

已使用 seo 0.2.41 的 audit-page，在回环 HTTP 上检查两份原创合成 HTML。阅读真实命令、完整 JSON 与限制。这个记录仅支持该版本和这两份输入的报告行为，不证明助手集成、广泛抓取、网站地图报告或搜索收录。

来源与许可

维护者：Ian Nuttall。原稿审阅版本：0.2.41。

固定提交：5b794fe9c8addbc227c49262bb6ac79ad8429452

许可证：Apache-2.0。已审阅固定版本的 LICENSE 和 package.json。项目名称与美术资源另有商标政策。

许可证来源 ↗ · 原始仓库 ↗

跟着对应教程检查

全部 Skills查看原始 Skill 来源 ↗