generate_report
Generate a shareable HTML SEO report for a project from its latest crawl and Search Console data, and get a public link to share with clients or…
Cost: 15 credits.
generate_report rolls up a project's latest crawl_site and pull_gsc_data results into a single, self-contained HTML report and returns a public link you can share with clients or teammates. Run crawl_site and/or pull_gsc_data first.
What it does
It reads the most recent successful crawl and Search Console pull for the project (whichever exist) and renders a light, readable summary:
- Site crawl — pages crawled, pages skipped, and basic on-page issues (missing titles, meta descriptions, or H1s, and error responses).
- Search performance — the current window's total clicks and impressions, plus your top queries and top pages.
The report is deliberately a summary, not a re-run of the analysis engines — it points you back to audit_onpage, audit_tech, audit_schema, find_quick_wins, detect_cannibalization, and analyze_content_decay for the deep breakdowns. Every report carries a small "powered by SeoGrep" footer.
If the project has neither a crawl nor a Search Console pull yet, the tool tells you to run crawl_site or pull_gsc_data first — and you are not charged.
Example
Ask your MCP client in plain language:
Generate a shareable SEO report for my example.com project.
Input
| Field | Type | Required | Description |
|---|---|---|---|
project_id | string (uuid) | Yes | The project to report on (from setup_project / list_projects). |
title | string | No | Optional report title. Defaults to 'SEO Report — <domain> — <date>'. |
Returns
The report's title, its report_id, and a public URL (/r/<slug>) that anyone with the link can open — no sign-in required. The link uses an unguessable 64-bit slug, and you can see all your reports on the Reports page of your dashboard.
research_keywords
Look up Google search volume, CPC, and competition for up to 100 keywords. Synchronous — returns a table immediately. Live keyword data is off during…
whats_next
Not sure what to do next? whats_next looks at where your project stands — crawl, audits, Search Console, reports — and tells you the single best next…