seo

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>.

Skills liên quan

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
Khi người dùng muốn lập kế hoạch, thiết kế hoặc triển khai một bài kiểm tra A/B hoặc thử nghiệm, hoặc xây dựng một chương trình thử nghiệm tăng trưởng. Cũng sử dụng khi người dùng đề cập đến "kiểm tra A/B," "kiểm tra phân chia," "thử nghiệm," "kiểm tra thay đổi này," "bản sao biến thể," "kiểm tra đa biến," "giả thuyết," "tôi có nên kiểm tra điều này không," "phiên bản nào tốt hơn," "kiểm tra hai phiên bản," "ý nghĩa thống kê," "tôi nên chạy kiểm tra này trong bao lâu," "thử nghiệm tăng trưởng," "tốc độ thử nghiệm," "tồn đọng thử
researchdata-analysismarketing
add-analytics-instrumentation
amplitude
Quy trình triển khai instrumentation analytics từ đầu đến cuối cho một PR, nhánh, tệp, thư mục hoặc tính năng. Đọc mã, xác định các sự kiện cần theo dõi và tạo kế hoạch instrumentation cụ thể — tất cả chỉ trong một lần. Dùng skill này bất cứ khi nào người dùng muốn thêm analytics vào một PR, yêu cầu “instrument this PR”, “add tracking to this branch”, “what analytics does this file need”, “instrument the checkout flow”, “run the full instrumentation workflow” hoặc bất kỳ yêu cầu nào hàm ý thực hiện toàn bộ quy trình từ mã...
developmentdata-analysisapi
ads
coreyhaines31
Khi người dùng muốn trợ giúp về các chiến dịch quảng cáo trả phí trên Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X hoặc các nền tảng quảng cáo khác. Cũng sử dụng khi người dùng đề cập đến 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,' 'LinkedIn ads,' 'ad budget,' 'cost per click,' 'ad spend,' hoặc 'should I run ads.' Sử dụng cho chiến lược chiến dịch, nhắm mục tiêu đối tượng, đặt giá thầu và tối ưu hóa. Đối với việc tạo nội dung quảng cáo hàng loạt và...
data-analysisresearchmarketing
ai-research-explore
lllllllama
We need to translate the given text from English to Vietnamese, preserving the name "ai-research-explore" and other technical terms. The instruction says: "Translate only the text inside <text>. Do not include the name unless it appears in the source text." The name "ai-research-explore" does not appear in the source text, so we should not include it. Also, preserve product names, protocol names, URLs, numbers, technical terms. The text includes terms like "Rigor Explore", "slug", "deep learning", "SOTA", "current_research", "explore_outputs/", "README-first", etc. We need to keep those as is or translate appropriately? The instruction says "preserve product names, protocol names, URLs, numbers, and technical terms." So "Rigor Explore" might be a product name? It says "Rigor Explore compatible skill slug" - likely a product name. Keep as is. "slug" is a technical term, keep. "deep learning" is a technical term, but can be translated as
data-analysisresearchapi
analytics
coreyhaines31
Khi người dùng muốn thiết lập, cải thiện hoặc kiểm tra việc theo dõi và đo lường analytics. Cũng sử dụng khi người dùng đề cập đến "thiết lập theo dõi," "GA4," "Google Analytics," "theo dõi chuyển đổi," "theo dõi sự kiện," "thông số UTM," "trình quản lý thẻ," "GTM," "triển khai analytics," "kế hoạch theo dõi," "làm thế nào để đo lường điều này," "theo dõi chuyển đổi," "quy kết," "Mixpanel," "Segment," "sự kiện của tôi có đang kích hoạt không," hoặc "analytics không hoạt động." Sử dụng bất cứ khi nào ai đó hỏi cách biết liệu một thứ có đ
researchdata-analysismarketing
aso
coreyhaines31
Khi người dùng muốn kiểm tra hoặc tối ưu hóa danh sách trên App Store hoặc Google Play. Cũng sử dụng khi người dùng đề cập đến 'kiểm tra ASO,' 'tối ưu hóa app store,' 'tối ưu danh sách ứng dụng của tôi,' 'cải thiện khả năng hiển thị ứng dụng,' 'thứ hạng app store,' 'kiểm tra danh sách của tôi,' 'tại sao mọi người không tải ứng dụng của tôi,' 'cải thiện tỷ lệ chuyển đổi ứng dụng,' 'tối ưu hóa từ khóa cho ứng dụng,' hoặc 'so sánh ứng dụng của tôi với đối thủ.' Sử dụng khi người dùng chia sẻ URL App Store hoặc Google Play và muốn cải thiện nó.
data-analysisresearchmarketing
attribution
coreyhaines31
Khi người dùng muốn xác định hoạt động marketing nào thực sự tạo ra chuyển đổi và doanh thu, chọn hoặc diễn giải một mô hình attribution, hoặc đối chiếu các con số mâu thuẫn giữa các công cụ. Cũng sử dụng khi người dùng đề cập đến "attribution," "attribution model," "first-touch vs last-touch," "multi-touch," "kênh nào tạo ra doanh thu," "CAC thực sự của tôi là bao nhiêu," "các dashboard của tôi không khớp nhau," "Google/Meta nói X nhưng GA nói Y," "media mix model," "MMM," "incrementality," "geo lift," "holdout test," "làm sao bạn...
researchdata-analysismarketing