Starter prompts
Copy one prompt into Claude, Codex or another MCP-compatible client. Replace the example properties and keep only the providers configured with the installation guide.
| Goal | Prompt |
|---|---|
| Compare Google and Bing | Google and Bing audit |
| Get a short cross-engine snapshot | Google and Bing quick comparison |
| Audit Google with optional GA4 | Google and GA4 audit |
| Investigate one URL | Single-page audit |
| Submit an eligible page | Google Indexing API workflow |
| Test 1.4.0 without provider access | Local tool smoke test |
| Test 1.5.0 local evidence tools | Local evidence smoke test |
| Compare matching weekdays | Weekday reference |
| Follow a declared page edit | Declared-change follow-up |
| Preview a supplied crawl export | Crawl export preview |
Google and Bing audit
Section titled “Google and Bing audit”Use this when both providers are configured. The Bing API key belongs in BING_WEBMASTER_API_KEY, not in the prompt. One user-level key covers the verified sites visible to that Bing account; the prompt still names the site passed to every call.
You have access to the gsc-mcp Google Search Console and Bing Webmaster tools.My Google property is: sc-domain:example.comMy Bing site is: https://example.com/
Work in this order:
1. Call get_capabilities, list_properties and bing_sites_list. Report only declared credentials and observed site access. Do not claim authentication from an env flag.
2. Read query, page and daily performance from both engines for 28 days. For each result, preserve the requested and observed windows. Mark clicks and impressions as measured, CTR as derived, and keep Google and Bing position semantics separate.
3. Run quick_wins, seo_striking_distance and prune_candidates once per engine. Pass engine="bing" for Bing. A page with measured clicks or impressions is protected from pruning. Check crawl and indexation separately before recommending removal.
4. Call compare_search_engines for query and page dimensions. Show click and impression deltas only if the tool reports equal exact observed windows. Never subtract positions across engines and do not infer causality from a difference.
5. Read Bing crawl, URL, feed and backlink data where relevant. Treat quota semantics, data freshness, non-empty crawl issue shapes, nested backlink rows and RemoveFeed runtime behavior as UNKNOWN or UNVERIFIED_RUNTIME when the tool says so. Do not use Bing keyword-research endpoints; they are not registered after HTTP 400 canaries.
6. Separate the report into measured facts, derived metrics and recommendations. Prioritize corrections with a named URL or query and the supporting metric.
7. If a correction changes a page or feed, stop before any mutation. State the exact tool, target and number of affected URLs or feeds, then request explicit confirmation. Do not call a write tool until that confirmation names the action.
8. After confirmation, call the selected write tool once. Report its returned status. An accepted request, HTTP 200 or last crawl date proves neither crawl nor indexation.
9. Define the later comparable window needed to measure the result. Do not attribute a change to the submission without comparable observed data.
Explicit Bing refusals are expected: traffic_drops and seo_lost_queries need exactadjacent periods; check_alerts and seo_cannibalization need bulk page-query data.Report the refusal reason rather than replacing it with guessed or N+1 data.This prompt requires gsc-mcp-tools>=1.2.0 or a current source checkout because earlier published versions do not expose the Bing tools.
Google and Bing quick comparison
Section titled “Google and Bing quick comparison”Use this when you want a bounded cross-engine snapshot rather than a full audit:
Compare Google and Bing performance for example.com over the last 28 days.
Google property: sc-domain:example.comBing site: https://example.com/
1. Confirm observed access with list_properties and bing_sites_list.2. Call compare_search_engines for query and page dimensions.3. Return the top 10 queries and pages per engine by impressions.4. Show clicks, impressions and derived CTR. Keep positions side by side.5. Show deltas only when the tool confirms equal exact observed windows.6. List three engine-specific opportunities, each backed by a query or URL.7. Separate observed facts, derived values and recommendations.8. Do not call a write tool.Google and GA4 audit
Section titled “Google and GA4 audit”You have access to a Google Search Console + GA4 MCP server.My site is: https://example.comMy GA4 property ID is: 123456789 (leave blank or remove this line if you don't use GA4)
Run a complete SEO audit in this order:
1. List my GSC properties to confirm the site is accessible.
2. Check active alerts (last 30 days). If severity "high" alerts exist, surface them immediately before continuing.
3. Performance overview for the last 28 days and 90 days. Highlight: - Total clicks and impressions - Average CTR and position - Notable trend between the two periods
4. Top quick wins: pages ranked 4-15 with high impressions and CTR below the benchmark. Give me the top 10, ordered by opportunity score.
5. Queries in striking distance (positions 6-15). Which pages could realistically reach the top 5 with targeted improvements?
6. Traffic drop diagnosis for the last 28 days vs. the prior period. Classify drops as: ranking_loss, ctr_collapse, or demand_decline.
7. Cannibalization check: identify queries where multiple pages compete and split click share.
8. Lost queries: queries that had clicks 90 days ago but have dropped to near zero in the last 28 days.
9. Indexing issues: inspect a named sample of up to 10 priority URLs and group only their returned verdicts by reason. Keep every uninspected URL unknown.
10. Sitemap audit: use sitemap_audit to check my main sitemap. How many URLs are declared vs. have Search Analytics page rows? Report visibility_verdict and without_search_data_sample. Do not infer indexation from this comparison.
11. Page-level deep dive on the top 3 pages by clicks: - Search analytics (queries, CTR, position) - Indexing status via URL inspection
12. If GA4 property ID was provided: - Organic landing page performance (sessions, bounce rate, conversions) - Traffic sources breakdown - User behavior by device and country
13. Cross-platform analysis (GSC + GA4) for the top 5 organic landing pages: combine GSC click data with GA4 engagement metrics to surface pages where traffic is high but engagement is poor.
14. Core Web Vitals: use crux_page_vitals on the top 3 pages by clicks. Report the verdict for LCP, INP, and CLS. Flag any "poor" ratings.
15. Schema validation: use schema_validate on the homepage and the top 2 pages by clicks. List detected schema types, invalid fields, and any recommendations.
16. Produce a prioritized action plan based on evidence and scope: - P0: active blocks or severe regressions with a named affected URL - P1: high-impact measured opportunities or invalid structured data - P2: lower-impact improvements and hypotheses that need more evidence For each item, name the evidence, affected scope, owner type and validation check.
Return all results as structured data. For each finding, include the specificpage or query, the metric value, and a one-sentence recommendation.Short Google audit
Section titled “Short Google audit”Use this when you want a fast summary without the full analysis:
Run a quick SEO health check for https://example.com:
1. Performance overview for 28 days (clicks, impressions, CTR, position).2. Top 5 page-level quick wins (positions 4-15 with high impressions and CTR below benchmark).3. Any active high-severity alerts.4. Indexing verdicts for a named sample of up to 10 priority URLs, grouped by reason.5. Three-sentence summary with the single most important action to take now.Single-page audit
Section titled “Single-page audit”Use when you want to investigate one URL specifically:
Audit this page in depth: https://example.com/my-page
1. Inspect the URL: indexing status, last crawl date, canonical, verdict.2. Search analytics for this page: top 10 queries, clicks, impressions, CTR, position.3. If it is not indexed, diagnose the reason and suggest the fix.4. If it is indexed, identify the top opportunity query to optimize for.5. Check if this page cannibalizes any other page on the same queries.6. Validate the JSON-LD schema on this page with schema_validate.7. Check Core Web Vitals with crux_page_vitals (desktop and mobile).Google Indexing API workflow
Section titled “Google Indexing API workflow”Google limits the Indexing API to pages containing JobPosting or BroadcastEvent embedded in a VideoObject. For other page types, do not call submit_url or submit_batch; use URL Inspection for diagnosis and normal discovery paths such as sitemaps and internal links. See Google’s official eligibility policy.
Use this prompt only after fixing an eligible page:
I just fixed this eligible JobPosting or livestream page:https://example.com/my-page
1. Inspect the current indexing status.2. Validate that the page contains eligible JobPosting or BroadcastEvent markup.3. If the verdict is not PASS or eligibility is not demonstrated, stop and explain why.4. If ready, state the exact URL, tool and notification type, then ask for confirmation.5. Call submit_url once only after I explicitly confirm that action.6. Report the returned status without claiming crawl or indexation. `submit_url` does not report a locally tracked quota value.7. Define when URL Inspection should be checked again for a later observation.Core Web Vitals audit
Section titled “Core Web Vitals audit”Use to investigate CWV performance across key pages:
Run a Core Web Vitals audit for https://example.com using crux_page_vitals.
Check these pages: /, /blog, /contact (replace with your key pages)Check both PHONE and DESKTOP form factors.
For each page and device:1. Report LCP, INP, CLS, FCP, TTFB with their rating (good/needs_improvement/poor).2. Flag any metric rated "poor" as a priority fix.3. List investigation areas for poor ratings (LCP = image/server, INP = JavaScript, CLS = layout shift, TTFB = server response time) and label them as hypotheses.4. Produce a summary table: page x metric x rating.Schema validation audit
Section titled “Schema validation audit”Use to check structured data coverage across the site:
Run a schema validation audit on these pages:- https://example.com/ (homepage)- https://example.com/faq (FAQ page)- https://example.com/blog/my-post (a blog post)
For each page, use schema_validate and report:1. Which schema types were detected.2. Which required fields are missing (and why they matter for Google).3. Which schema types are recommended based on the URL pattern but not present.4. Overall verdict: healthy, missing_schemas, invalid_schemas, or fetch_error.5. Priority fixes ordered by SEO impact.GA4-only audit
Section titled “GA4-only audit”Use when you want to focus on analytics without GSC data:
Run a GA4 performance audit for property ID 123456789, last 28 days:
1. Organic landing pages: top 10 by sessions, with bounce rate and conversions.2. Traffic sources: sessions by channel group (Organic, Direct, Referral, etc.).3. User behavior: sessions and engagement rate by device and by country (top 10).4. Conversion funnel: which pages generated conversions? Which events fired most?5. Realtime: how many active users right now, and on which pages?Sitemap audit
Section titled “Sitemap audit”Use when you want to compare a sitemap with Search Analytics visibility:
Audit my sitemap at https://example.com/sitemap.xml for the property sc-domain:example.com.
Use sitemap_audit and report:1. Is this a sitemap index or a regular urlset?2. How many URLs are declared in the sitemap?3. How many of those URLs appear in GSC search data (last 90 days)?4. What is visibility_verdict? This measures search data, not indexation.5. If partial_search_visibility, show without_search_data_sample for URL inspection.Test 1.4.0 without provider access
Section titled “Test 1.4.0 without provider access”Release 1.4.0 exposes 89 tools by default. A startup family selection can expose fewer; see installation. This smoke test uses synthetic text and does not verify Google or Bing access.
Use Search Console MCP for a read-only local smoke test.1. Call get_capabilities and check that editorial_audit, rewrite_fidelity_check, search_weekday_reference, seo_change_impact and crawl_import_preview are exposed. Report missing tools or startup-family restrictions explicitly.2. Call editorial_audit with text="The catch? Read this guide.", language="en", format="plain". Report the status, coverage and returned rule warnings.3. Call rewrite_fidelity_check with original="The report covers 12 pages.", revised="The report covers 20 pages.", language="en", format="plain". Inspect the number-change candidates and their original/revised locations.4. Preserve each result's metadata and distinguish PASS, FAIL and unverified checks. Do not call Google/Bing, fetch pages, modify files or publish anything.A clean mechanical result does not certify factual truth or semantic fidelity.See draft and rewrite workflows for input bounds and result fields.
Weekday reference
Section titled “Weekday reference”Replace the property with one you own. This check requires observed Google access.
Use search_weekday_reference for sc-domain:example.com with days=28,max_requests=20 and limit=10. First verify access to that exact Google property.Report the effective dates, matching weekdays, coverage, requested data state,clicks and impressions. Leave missing or incompatible metrics unavailable.The comparison describes observed windows; do not infer annual seasonality or cause.Do not perform any write operation.Declared-change follow-up
Section titled “Declared-change follow-up”Provide the actual event, URL and date, then agree on explicit equal before/after windows.
Use seo_change_impact to inspect a page change I explicitly declare.Before calling it, ask me for the Google property, exact page URL, event date,change description and known concurrent changes if they are missing.Propose equal, disjoint before/after windows and wait for me to confirm the inputs.Preserve the event as caller-declared, retain coverage and compare available metrics.Separate measured changes from hypotheses; do not claim that my edit caused a gain.Do not persist the event or perform any write operation.Crawl export preview
Section titled “Crawl export preview”Supply a SiteOne JSON export without credentials. Exporter-shaped fixtures validate the adapter; a real exporter run remains a separate check.
Use crawl_import_preview on the SiteOne JSON export I provide, with producer="siteone".If I have not provided an export, ask for it rather than inventing one.Report accepted, rejected and omitted counts, producer declarations, coverage,hashes and errors. Treat imported scores as crawler heuristics, not ranking signals.Do not launch a crawler, fetch URLs, read files, install software, persist data or join GSC.See bounded audit workflows for the weekday, event and import contracts.
Test 1.5.0 local evidence tools
Section titled “Test 1.5.0 local evidence tools”Version 1.6.0 retains the 96 tools introduced in 1.5.0; startup family selection may expose fewer. This uses a synthetic URL and makes no provider request.
Run a read-only smoke test of Search Console MCP 1.6.0.Check capabilities for crawl_log_audit, crawl_snapshot_import, crawl_snapshot_read,crawl_snapshot_delete, crawl_snapshot_join, crawl_diff and indexing_evidence_matrix.State any startup-family restriction. Call indexing_evidence_matrix withsite="sc-domain:example.com", urls=["https://example.com/"], reports_json="[]".Verify that missing inspection and rendering remain unavailable/unknown andprovider_requests is zero. Preserve the result metadata.Do not fetch pages, contact Google/Bing, read local logs, create snapshots or write.This synthetic case checks the contract, not real indexing or provider access.Reconcile supplied indexing observations
Section titled “Reconcile supplied indexing observations”Use indexing_evidence_matrix on the explicit URLs and existing reports I supply.Ask for the exact property and reports if missing. Preserve original responsemetadata and dates; do not claim the supplied metadata authenticates its origin.Keep inspection, HTML, search visibility and declared sitemap/business membershipseparate. Show source-referenced contradictions and missing cells. A log pathmatch strips queries and is only a candidate association. Do not fetch again,infer current indexing/rendering or extrapolate this sample to the whole site.Evaluate a crawl snapshot without saving it
Section titled “Evaluate a crawl snapshot without saving it”On the authorized SiteOne JSON export I supply, call crawl_snapshot_import withthe exact property, producer="siteone" and persist=false. Show source hash,version, accepted/excluded/duplicate rows and unknown collection/selection fields.Do not persist, launch a crawler or install software. If I separately authorizepersistence, keep the returned snapshot_id with its exact owning property.For two existing snapshots I select, use crawl_diff; absence from one inventoryis not deletion or deindexing. Missing/incompatible fields remain unavailable.The local snapshot contract and indexing matrix document identity, provenance and bounds.