Use MCP with full access
Use up to 30 scoped tools across an eligible paid account for Search Console, linked GA4, Technical SEO audits, Generative AI imports, SEO planning data, and optional write permissions.
Product guide · Updated October 2026
Understand full MCP access
Eligible paid access lets an owner or member approve up to 11 scopes for the selected CrawlRaven account. A paid grant is not pinned to one free-preview site and is not subject to the free preview’s 20-call daily allowance. It remains bound to one client, user, and account. Most tools only read data. Three write scopes change one record at a time without further approval, and annotations:write only proposes note changes that the same user approves in CrawlRaven.
| Scope | What it provides |
|---|---|
| websites:read | Website IDs, names, lifecycle state, activation, and full-workspace access. |
| search_performance:read | Overview, daily totals, bounded Query and Page results, page-query mapping, and imported Generative AI snapshots. |
| opportunities:read | Persisted opportunities, Priority, evidence, recommended actions, and the prioritized SEO plan. |
| targets:read | Durable target plans, intended URLs, groups, status, imported research fields, and target-to-page alignment. |
| annotations:read | Active manual notes, Google updates, and opportunity milestones from the timeline. |
| analytics:read | Bounded reports from the GA4 property already linked to the website. |
| technical_seo:read | Stored Technical SEO audits, findings, and comparisons. It cannot start audits. |
| opportunities:write | Resolve, ignore, snooze, or reopen one opportunity at a time, without further approval. |
| targets:write | Add a target keyword, assign its intended page, or change its priority, without further approval. |
| notes:write | Create, update, archive, or restore manual notes directly, without further approval, and list archived notes. |
| annotations:write | Plan manual note create, update, archive, or restore operations for same-user approval, check plan status, and list archived notes. |
The complete paid catalog has 30 tools. A client sees only the subset covered by its approved scopes, and a tool that needs a second scope, such as get_page_query_mapping, appears only when both are approved. The MCP tool reference lists every tool with its scope and parameters.
Connect with https://mcp.crawlraven.com/mcp, complete browser OAuth, review the selected account and scopes, then begin with list_websites. Use the returned website_id for every site-specific tool. Existing connections are never widened silently; reconnect to add a newly available permission.
Build workflows that chain tools
Replace [your site] with the exact CrawlRaven site name or domain in the full-access prompts below.
| Workflow | Prompt |
|---|---|
| Monthly search review | For [your site], compare the last 90 days with the preceding period, identify the returned pages and queries with the largest click losses, and check the timeline for nearby notes or Google updates. |
| Decay triage | Find returned pages that lost clicks over 90 days, match them to current content-decay opportunities, and rank the resulting actions by Priority and current page traffic. |
| Page refresh research | For [your site], list the queries attributed to exactly [page URL] from [start date] through [end date]. Combine them with the page's current public content, then propose refresh ideas grounded in the returned query evidence. Keep query evidence separate from content observations and state any truncation. |
| Planning coverage | Compare targeted keywords with the bounded top-query corpus, then flag targets with no planned URL or no matching returned query. State the evidence boundary. |
| Search-to-outcome review | Combine the last 28 days of Search Console movement with linked GA4 landing-page sessions and key events for the same complete-day period. Keep query evidence separate from page-level outcomes and report truncation. |
| Record a reviewed change | After reviewing the evidence, plan a concise manual timeline note for [date]. Show the exact values and approval link, and do not say it changed until I approve it in CrawlRaven and status confirms completion. |
| Audit follow-up | Compare the latest finished Technical SEO audit for [your site] with the previous one, list new findings by severity with their suggested fixes, and separate fixed findings whose pages were not rechecked. |
| Target alignment | For [your site], find target keywords whose intended page is not the page leading in clicks, then inspect each intended page's queries with page-query mapping. |
| Weekly backlog | Turn the highest-priority active opportunities into a five-item implementation brief with the reason, evidence, affected page, and recommended action. |
Browse more copyable examples for founders, SEO specialists, agencies, content teams, and developers in Prompts by role.
Choose windows and page only when needed
| Tool group | Default | Maximum and window |
|---|---|---|
| Query and Page lists | 25 rows | 100 rows per page; rolling 1–365 days or exact inclusive dates spanning at most 365 days. |
| Opportunities and Target Keywords | 25 rows | 100 rows per page; no reporting-window parameter. |
| Prioritized SEO plan | 25 rows | Up to 100 in one bounded ranked result; no cursor and no reporting window. |
| Target alignment and page-query mapping | 25 rows | 100 rows per page with a reporting window. A filtered page can be empty while next_cursor continues. |
| Technical SEO audits and findings | 25 rows | 100 rows per page; reads stored audits only. |
| Generative AI imports and pages | 10 imports; 50 pages | Up to 10 imports and 100 pages per page; dates follow the imported snapshot in Pacific Time. |
| Active annotations | 100 rows | 200 rows per page; choose 1 through 400 days. |
| Archived annotations | 25 rows | 100 rows per page; cursor-paginated and not time-bound. |
| Analytics summary | 28 complete days | Rolling or exact windows up to 365 complete UTC days; one result with up to 365 daily points. |
| Analytics breakdown | 25 top rows | Up to 100 rows; no cursor, so inspect truncated and narrow the dimension or filters. |
| Annotation plan or status | One result | Plans expire after 15 minutes; status lookup does not repeat a mutation. |
| Websites | All returned | Up to 100 websites; no cursor pagination. |
| Overview and daily search performance | 28 days | Rolling 1–365 days or exact inclusive dates spanning at most 365 days. |
When next_cursor is present, pass it back unchanged as cursor with the same site, window, search, exact page filter, and status. Changing that scope invalidates the cursor. Ask the agent to stop when the cursor is empty and to report any truncation rather than implying the source was exhaustive.
Know what full access still cannot do
- It cannot change Search Console, Analytics properties, sites, billing, or administration; run exports; or call arbitrary API routes. Opportunity status, target keywords, and manual notes change only with the matching write permission.
- It cannot refresh Opportunities, start Technical SEO audits, import Generative AI exports, or fetch arbitrary URLs, files, webhooks, or email.
- Analytics tools read only the GA4 property already linked in CrawlRaven. They cannot connect or switch a property, expose credentials, or change Google configuration.
- Manage manual notes directly changes manual notes without further approval. Propose annotation changes can only propose create, update, archive, or restore for manual notes, and the same authorizing user must approve every exact plan in CrawlRaven within 15 minutes.
- Update, archive, and restore are version-checked; stale plans conflict. Create retries are idempotent within the documented 90-day retention window.
- Derived and imported events are immutable. MCP can archive and restore manual notes but can never permanently delete one.
list_target_keywordsreturns the durable plan only. Useget_target_page_alignmentfor observed pages and mismatches.- Paid
list_queriesaccepts an exact absolute HTTP(S)pageURL and can combine it with query-textsearch. This extends the existing tool; it is not a separate page-query tool. Query and Page tools still do not expose the app’s country, device, or branded filters.
Tool results leave CrawlRaven for the connected client and model provider. Review their data policies, connect only clients you trust with Search Console, linked GA4, and CrawlRaven planning data, and revoke old connections from MCP connections. Grants expire after 90 days. If paid access lapses, the grant remains visible and revocable but returns no data until paid access is restored.
See the MCP server reference for exact parameters, client commands, OAuth behavior, and error recovery.