seo

作者: iannuttall

Free Google Search Console MCP server and CLI for AI agents. Reads your real Search Console, Google Analytics, Bing Webmaster Tools, Clicky and Simple Analytics data, plus DataForSEO and Ahrefs keyword research. Use it for any SEO question - why Google traffic or clicks dropped, organic traffic decline, quick wins, low CTR, striking distance keywords, content decay and declining pages, keyword cannibalization, indexing and URL inspection, one page's queries, Google update impact, the...

npx skills add https://github.com/iannuttall/seo --skill seo

seo

seo reads Search Console, Google Analytics, Bing Webmaster Tools, Clicky and Simple Analytics data, crawls sites, checks live pages, and gets keyword and backlink data from DataForSEO or Ahrefs.

Use the MCP tools when they are connected (hosted at https://seoskill.dev/mcp, or local with seo mcp serve). Otherwise use the CLI: seo, or npx -y seo. Add --json for JSON.

seo crawl --url <url> needs no sign-in and works on any site, local and staging too. The other commands need the person's data: seo login prints a link for them to approve, then run it again.

CLIMCP toolReturns
seo next --site <site>seo_nextThe next step in the SEO loop for the site, with its jobs; start here when asked to work on a site's SEO
seo report --site <site>seo_reportSearch Console overview and sections; with no site, last week across the sites in the weekly site audit; --section teardown when asked to write a teardown of any site
seo page --url <url>seo_pageOne URL: live page, index status, queries
seo compare --site <site> --date <date>seo_compareBefore and after a date, with Google updates
seo index --site <site>seo_indexGoogle's indexing reasons, labelled, and pages that lost their clicks
seo submit <url...>, --indexmysiteseo_submitAsk Bing and others to crawl pages (IndexNow, free, after seo submit key <site>), or send them to Google with Index My Site (the person's credits; quote first, send with --yes or confirm: true only after they agree)
seo research <action>seo_researchKeywords, keyword ideas, SERP (organic position, mobile) and SERP overlap, whether Google indexed any URL (index_check), top pages, competitors, backlinks, pages by backlinks, link gaps, AI answer citations, link and listicle targets (--pages, or ai_answers with competitors), for a site, subfolder (example.com/blog/) or page; provider optional; next pages are free for a day
seo data --site <site>seo_dataRaw Search Console, Bing, Clicky, Simple Analytics or Google Analytics rows
seo crawl --url <url>seo_crawlTechnical issues across a site
seo internal-links --site <site> or --url <url>seo_internal_linksLinks to add across a site, or to one page
seo lint <files> or --url <url>seo_lintLines in a draft, title, description or live page that read as AI-written, each with a fix; --only ai for AI patterns alone; no sign-in
seo feedbackseo_feedbackSend a bug or idea about these tools, with your proposed fix, to the maintainer; show the person the text and send only if they agree
seo sitesseo_sitesThe properties the person can read
seo site new <folder>, then seo site guide <step>CLI onlyBuild a new data-driven site on Astro and Cloudflare, one step at a time. Its build runs seo site check

Each result ends with the command to run next. Start small and ask for more: a site, then a --section (section), then --detail rows or full. seo <command> --help shows the options.

The SEO loop

When the person asks you to use seo or improve a site's SEO without a narrower question, run seo next. It keeps the site's business context (what it sells, who buys, conversion pages) and its issues list, and returns one step: research the business context, unblock pages, improve pages that rank, or plan new pages and earn links. Do the step's jobs, ask the person before anything goes live, mark each job, then run seo next again.

Issues kept between sessions

seo report --site <site> --section issues (section "issues") checks the site again and keeps a list of what it found, each with an id, the latest check and what the person marked it. Record what the person decided: --mark fixed or --mark ignored with --issues <id>,<id> (mark, issues, optional note). "Fixed" is the person's word; the list says when the check still finds it. The hosted server, and a CLI linked with seo login, keep the list with the account, for every site; an unlinked CLI keeps it on this machine. If the person has a list saved from before, such as .seo/issues.json, pass its contents once as saved to carry its marks over.

Google updates

When the person asks whether a Google update hit the site, run seo report --site <site> --section google-updates (section "google-updates"). It compares the latest ranking update's days with the same days before and says whether that is outside the site's normal movement. --end-date (end_date) picks an earlier update. Report it as timing, never as the cause.

Indexing reasons each week

seo index inspects known URLs in a fixed order (lost-click pages, Search Console pages by clicks, the sitemap, the rest), 100 by default, and labels each Google reason fix, check, expected or indexed from a live check. In the CLI or local MCP, --max-urls (max_urls) asks for more, up to today's quota, and reuses saved inspections up to 7 days old, so paging or --detail full costs no quota. Run it once for a baseline and keep the full result (--detail full). Run it again each week with the same number and compare by URL and reason: a new reason, or a URL that moved to fix, is what to report. seo keeps no history, so you store the results. Once this runs weekly, the person can turn off Search Console's indexing emails. For one URL from such an email, run seo page --url <url>.

相关技能

conversion-tracking
coreyhaines31
When the user wants to set up, audit, or fix conversion tracking to Google Ads, Meta, GA4, LinkedIn, and TikTok, or asks why conversions are missing or doubled: GTM, pixels, CAPI, Enhanced Conversions, offline imports. Fire on confirmed success, not the submit click; verify a test conversion arrives; diagnose before changing; offer free paths and disclose partner tools. For tracking plans, see analytics. For attribution, see attribution. For bidding, see ads.
marketingdata-analysisapi
ab-testing
coreyhaines31
当用户想要规划、设计或实施A/B测试或实验,或构建增长实验项目时使用。也适用于用户提及"A/B测试"、"拆分测试"、"实验"、"测试这个改动"、"变体文案"、"多变量测试"、"假设"、"我应该测试这个吗"、"哪个版本更好"、"测试两个版本"、"统计显著性"、"这个测试应该运行多久"、"增长实验"、"实验速度"、"实验积压"、"ICE评分"、"实验...
researchdata-analysismarketing
add-analytics-instrumentation
amplitude
针对 PR、分支、文件、目录或功能的端到端分析埋点工作流。读取代码,找出应跟踪的事件,并一次性生成具体的埋点计划。每当用户想要为 PR 添加分析埋点、询问“为这个 PR 添加埋点”“为这个分支添加跟踪”“这个文件需要哪些分析埋点”“为结账流程添加埋点”“运行完整的埋点工作流”,或提出任何意味着要从代码开始……的请求时,都使用此技能。
developmentdata-analysisapi
ads
coreyhaines31
当用户需要关于Google Ads、Meta(Facebook/Instagram)、LinkedIn、Twitter/X或其他广告平台的付费广告活动帮助时使用。当用户提及“PPC”、“付费媒体”、“ROAS”、“CPA”、“广告活动”、“再营销”、“受众定位”、“Google Ads”、“Facebook广告”、“LinkedIn广告”、“广告预算”、“每次点击费用”、“广告支出”或“我应该投放广告吗”时也适用。用于广告活动策略、受众定位、出价和优化。对于批量广告创意生成和...
data-analysisresearchmarketing
ai-research-explore
lllllllama
Rigor Explore compatible skill slug for meaningful and potentially novel deep learning research candidates. Use when the researcher has chosen the task family, dataset, benchmark, evaluation method, provided SOTA references, and wants candidate-only exploration on top of `current_research` with auditable repo understanding, idea gating, fair comparison, and governed experiments written to `explore_outputs/`. Do not use for README-first trusted reproduction, open-ended direction finding,...
data-analysisresearchapi
analytics
coreyhaines31
当用户想要设置、改进或审计分析追踪和测量时使用。也适用于用户提及“设置追踪”、“GA4”、“Google Analytics”、“转化追踪”、“事件追踪”、“UTM参数”、“标签管理器”、“GTM”、“分析实施”、“追踪计划”、“我该如何测量这个”、“追踪转化”、“归因”、“Mixpanel”、“Segment”、“我的事件是否触发”或“分析无法正常工作”时。每当有人询问如何判断某件事是否正常运作时,也使用此技能。
researchdata-analysismarketing
aso
coreyhaines31
当用户想要审核或优化App Store或Google Play上的应用列表时使用。也适用于用户提及'ASO审核'、'应用商店优化'、'优化我的应用列表'、'提升应用可见度'、'应用商店排名'、'审核我的列表'、'为什么没人下载我的应用'、'提升应用转化率'、'应用关键词优化'或'将我的应用与竞品对比'时。当用户分享App Store或Google Play链接并希望改进时使用。
data-analysisresearchmarketing
attribution
coreyhaines31
当用户想要弄清楚哪些营销活动真正驱动转化和收入时,选择或解读归因模型,或协调不同工具之间相互冲突的数据。当用户提到"归因"、"归因模型"、"首次触点与末次触点"、"多触点"、"哪个渠道驱动收入"、"我真实的CAC是多少"、"我的仪表盘数据不一致"、"Google/Meta说X但GA说Y"、"媒体组合模型"、"MMM"、"增量性"、"地理提升"、"留存测试"、"你是如何...
researchdata-analysismarketing