SEO MCP server — backlinks, domain authority, tech stack, and 18+ tools via Common Crawl.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get backlinks for up to 50 domains at once
Get backlinks for up to 50 domains at once
| Argument | Type | Description |
|---|---|---|
| domains* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domains"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}Check remaining credit balance
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Mark a queued task done with a plain-text summary (max 2000 characters) of what you found and what you did. The user sees it in RankParse.
| Argument | Type | Description |
|---|---|---|
| summary* | string | |
| task_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"task_id",
"summary"
],
"properties": {
"summary": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"task_id": {
"type": "string",
"pattern": "^tsk_[A-Za-z0-9_-]{16,40}$"
}
},
"additionalProperties": false
}Get tasks the user queued for you in RankParse. At the start of any RankParse session, call get_agent_tasks to see work the user queued for you. Work on a task, then call complete_agent_task with a short plain-text summary.
| Argument | Type | Description |
|---|---|---|
| status | string | |
| site_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"status": {
"enum": [
"open",
"claimed",
"all"
],
"type": "string"
},
"site_id": {
"type": "string"
}
},
"additionalProperties": false
}Get anchor text distribution for a domain
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get backlinks for a domain. Default sort=importance returns aggregated referrer rows; sort=recent returns URL-level freshest links. Optional filters: from_domain, link_type, score.
| Argument | Type | Description |
|---|---|---|
| sort | string | |
| limit | number | |
| score | boolean | |
| domain* | string | |
| link_type | string | |
| from_domain | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"sort": {
"enum": [
"importance",
"recent"
],
"type": "string"
},
"limit": {
"type": "number"
},
"score": {
"type": "boolean"
},
"domain": {
"type": "string"
},
"link_type": {
"type": "string"
},
"from_domain": {
"type": "string"
}
},
"additionalProperties": false
}Find domains linking to a competitor but not to you: ranked link-building prospects. Under time budget the response may come back with partial=true and scored=false, meaning the results are the raw gap set without domain-authority ranking; retrying the same request usually returns a fully scored answer.
| Argument | Type | Description |
|---|---|---|
| vs* | string | |
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain",
"vs"
],
"properties": {
"vs": {
"type": "string"
},
"limit": {
"type": "number",
"maximum": 200,
"minimum": 1
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get first/last seen dates and total snapshot count for a domain (source: Wayback Machine)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get authority score for a domain. If the response has partial=true the lookup timed out or was incomplete: a null score means the authority is unknown (not zero) and the credit was refunded, so retry rather than treating the domain as having no authority.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Find domains linking to all queried domains
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domains* | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domains"
],
"properties": {
"limit": {
"type": "number"
},
"domains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 2
}
},
"additionalProperties": false
}Get inbound edge count and linking domain stats
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}List the Google Ads accounts the connected Google user can access, as 10-digit customer IDs. Use this to help a user pick which account to select when they have more than one. Requires Google Ads to be connected and an Ads account selected. Direct the user to rankparse.com/dashboard/integrations. Returns search volume and competition data, NOT keyword rankings; use the Google Search Console tools for ranking and position data.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Discover NEW keyword ideas from seed terms and/or a URL, with average monthly search volume, competition level, and top-of-page bid ranges. Use this for keyword research and content planning: "what should I target?". Supply seed keywords, a URL, or both. Requires Google Ads to be connected and an Ads account selected. Direct the user to rankparse.com/dashboard/integrations. Returns search volume and competition data, NOT keyword rankings; use the Google Search Console tools for ranking and position data.
| Argument | Type | Description |
|---|---|---|
| url | string | A page or site URL to derive keyword ideas from, e.g. "https://example.com/pricing" |
| limit | number | Max ideas to return (default Google decides, max 1000) |
| keywords | array | Seed keywords to expand from, e.g. ["seo tools", "backlink checker"]. Max 20; provide these and/or url. |
| language | string | Language resource name, default "languageConstants/1000" (English) |
| geo_target_constants | array | Location resource names, default ["geoTargetConstants/2840"] (United States). Max 10. |
| keyword_plan_network | string | Search network to estimate against (default GOOGLE_SEARCH) |
| include_adult_keywords | boolean | Include adult keywords in results (default false) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"url": {
"type": "string",
"description": "A page or site URL to derive keyword ideas from, e.g. \"https://example.com/pricing\""
},
"limit": {
"type": "number",
"description": "Max ideas to return (default Google decides, max 1000)"
},
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "Seed keywords to expand from, e.g. [\"seo tools\", \"backlink checker\"]. Max 20; provide these and/or url."
},
"language": {
"type": "string",
"description": "Language resource name, default \"languageConstants/1000\" (English)"
},
"geo_target_constants": {
"type": "array",
"items": {
"type": "string"
},
"description": "Location resource names, default [\"geoTargetConstants/2840\"] (United States). Max 10."
},
"keyword_plan_network": {
"enum": [
"GOOGLE_SEARCH",
"GOOGLE_SEARCH_AND_PARTNERS"
],
"type": "string",
"description": "Search network to estimate against (default GOOGLE_SEARCH)"
},
"include_adult_keywords": {
"type": "boolean",
"description": "Include adult keywords in results (default false)"
}
},
"additionalProperties": false
}Get average monthly search volume, competition level, and top-of-page bid ranges for a SPECIFIC list of keywords, with no expansion into related terms. Use this when the user already has keywords in mind and wants them sized: "how much traffic are these worth?". For discovering new keywords instead, use get_google_ads_keyword_ideas. Requires Google Ads to be connected and an Ads account selected. Direct the user to rankparse.com/dashboard/integrations. Returns search volume and competition data, NOT keyword rankings; use the Google Search Console tools for ranking and position data.
| Argument | Type | Description |
|---|---|---|
| keywords* | array | The exact keywords to look up, e.g. ["seo api", "rank tracker"]. Max 200 per call; extras are dropped and reported via the "truncated" flag. |
| language | string | Language resource name, default "languageConstants/1000" (English) |
| geo_target_constants | array | Location resource names, default ["geoTargetConstants/2840"] (United States). Max 10. |
| keyword_plan_network | string | Search network to estimate against (default GOOGLE_SEARCH) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"description": "The exact keywords to look up, e.g. [\"seo api\", \"rank tracker\"]. Max 200 per call; extras are dropped and reported via the \"truncated\" flag."
},
"language": {
"type": "string",
"description": "Language resource name, default \"languageConstants/1000\" (English)"
},
"geo_target_constants": {
"type": "array",
"items": {
"type": "string"
},
"description": "Location resource names, default [\"geoTargetConstants/2840\"] (United States). Max 10."
},
"keyword_plan_network": {
"enum": [
"GOOGLE_SEARCH",
"GOOGLE_SEARCH_AND_PARTNERS"
],
"type": "string",
"description": "Search network to estimate against (default GOOGLE_SEARCH)"
}
},
"additionalProperties": false
}Get search traffic broken down by country. Useful for understanding geographic audience and international SEO performance. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Get daily search performance trends (clicks, impressions, CTR, position) over a date range. Useful for spotting ranking changes, traffic drops, or algorithm update impact. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Get search traffic broken down by device type (desktop, mobile, tablet). Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Find pages with high impressions but low CTR: pages that Google is showing frequently but users aren't clicking. Good starting point for title/description rewrites. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| maxCtr | number | Only include pages with CTR at or below this value 0–1 (default 0.05 = 5%) |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
| minImpressions | number | Only include pages with at least this many impressions (default 500) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"maxCtr": {
"type": "number",
"description": "Only include pages with CTR at or below this value 0–1 (default 0.05 = 5%)"
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"minImpressions": {
"type": "number",
"description": "Only include pages with at least this many impressions (default 500)"
}
},
"additionalProperties": false
}Find search queries with high impressions but low CTR. These are ranking but not getting clicked, usually because the title or meta description is weak or misleading. Fixing these is typically higher ROI than chasing new rankings. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| maxCtr | number | Only include queries with CTR at or below this value 0–1 (default 0.05 = 5%) |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 50, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
| minImpressions | number | Only include queries with at least this many impressions (default 100) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"maxCtr": {
"type": "number",
"description": "Only include queries with CTR at or below this value 0–1 (default 0.05 = 5%)"
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 50, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"minImpressions": {
"type": "number",
"description": "Only include queries with at least this many impressions (default 100)"
}
},
"additionalProperties": false
}Find queries where the site ranks on positions 8–20 (page 1 bottom / page 2), the "quick win" zone where small improvements can meaningfully increase clicks. Returns queries sorted by clicks descending (GSC API default). Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 50, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
| maxPosition | number | Maximum average position (default 20) |
| minPosition | number | Minimum average position (default 8) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 50, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"maxPosition": {
"type": "number",
"description": "Maximum average position (default 20)"
},
"minPosition": {
"type": "number",
"description": "Minimum average position (default 8)"
}
},
"additionalProperties": false
}Get search queries driving traffic to a specific page. Useful for understanding what a page ranks for. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| page* | string | Full page URL e.g. "https://example.com/blog/post" |
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"page",
"startDate",
"endDate"
],
"properties": {
"page": {
"type": "string",
"description": "Full page URL e.g. \"https://example.com/blog/post\""
},
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Analyze search performance for a URL segment, e.g. all blog posts ("/blog/"), all product pages ("/products/"), or all docs ("/docs/"). Returns the top pages within that segment by clicks. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
| urlPattern* | string | URL substring to filter by e.g. "/blog/" or "/products/" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"urlPattern",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
},
"urlPattern": {
"type": "string",
"description": "URL substring to filter by e.g. \"/blog/\" or \"/products/\""
}
},
"additionalProperties": false
}Get daily click/impression/CTR/position trend for a specific page. Use this to see how a single page's search performance has changed over time, useful for measuring the impact of a content update or spotting a ranking drop. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| page* | string | Full page URL e.g. "https://example.com/blog/post" |
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"page",
"startDate",
"endDate"
],
"properties": {
"page": {
"type": "string",
"description": "Full page URL e.g. \"https://example.com/blog/post\""
},
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}List all Google Search Console properties (sites) connected to this account. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the properties visible to any of them are listed once each.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get query+page combinations: which exact queries are landing on which pages. Essential for detecting keyword cannibalization (multiple pages competing for the same query) and understanding the search funnel. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 100, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 100, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Get all pages that rank for a specific search query. Useful for identifying which pages compete for the same keyword. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| query* | string | Search query to look up e.g. "best seo tools" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"query",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"query": {
"type": "string",
"description": "Search query to look up e.g. \"best seo tools\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Get daily click/impression/CTR/position trend for a specific search query. Use this to track how a particular keyword's ranking and traffic evolves over time. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| query* | string | Search query to track e.g. "best seo tools" |
| endDate* | string | End date YYYY-MM-DD |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"query",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"query": {
"type": "string",
"description": "Search query to track e.g. \"best seo tools\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Break down traffic by how the site appears in Google Search: organic web results, rich results, AMP, image search, video, news, etc. Shows which search features are driving impressions and clicks. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}List all submitted sitemaps for a property, including submission date, last download time, URL counts, and any errors or warnings. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
}
},
"additionalProperties": false
}Get the top pages on a site by clicks from Google Search, with impressions, CTR, and average position. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Get the top search queries driving traffic to a site, ordered by clicks. Shows clicks, impressions, CTR, and average position for each query. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| site* | string | Property URL e.g. "https://example.com" or "sc-domain:example.com" |
| endDate* | string | End date YYYY-MM-DD |
| rowLimit | number | Max rows (default 25, max 1000) |
| startDate* | string | Start date YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"startDate",
"endDate"
],
"properties": {
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\" or \"sc-domain:example.com\""
},
"endDate": {
"type": "string",
"description": "End date YYYY-MM-DD"
},
"rowLimit": {
"type": "number",
"description": "Max rows (default 25, max 1000)"
},
"startDate": {
"type": "string",
"description": "Start date YYYY-MM-DD"
}
},
"additionalProperties": false
}Inspect a specific URL's indexing status in Google Search. Returns whether the page is indexed, coverage state, last crawl time, mobile usability, and rich results status. Requires Google Search Console to be connected. Direct the user to rankparse.com/dashboard/integrations to connect it. When several Google accounts are connected, the property is read through the account that can see it.
| Argument | Type | Description |
|---|---|---|
| url* | string | Full URL to inspect e.g. "https://example.com/blog/post" |
| site* | string | Property URL e.g. "https://example.com" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Full URL to inspect e.g. \"https://example.com/blog/post\""
},
"site": {
"type": "string",
"description": "Property URL e.g. \"https://example.com\""
}
},
"additionalProperties": false
}Get internal link structure for a domain (v1 stub)
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get the stored day-by-day ranking history for one keyword on one search engine over a date range. Reads RankParse snapshots synced on a schedule; it is not a live SERP check. History is inherently single-engine, so engine is required (use get_keyword_rankings first to compare across engines). Days with no synced data are simply absent from rows rather than filled with a zero or placeholder value -- do not treat a missing date as "not ranking". Bing and Yandex are opt-in and lower-frequency than Google; their responses may report availability as provider_limited, meaning that provider did not return enough data for that day rather than the keyword ranking nowhere.
| Argument | Type | Description |
|---|---|---|
| engine* | string | Search engine to get history for (required -- history is always single-engine) |
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
| end_date* | string | End of the range, inclusive, as YYYY-MM-DD |
| dimension | string | Breakdown of the daily rows. Default "total" is one row per day; "device" is one row per day per device (desktop/mobile/tablet) with a device field on each row. Device rows exist only where the provider synced them (always for Google; Yandex only when its device breakdown is enabled), so an empty device history for a keyword with total history means "not synced per-device", not "no traffic". |
| keyword_id* | string | Tracked keyword ID, from list_tracked_keywords |
| start_date* | string | Start of the range, inclusive, as YYYY-MM-DD |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id",
"keyword_id",
"engine",
"start_date",
"end_date"
],
"properties": {
"engine": {
"enum": [
"google",
"bing",
"yandex"
],
"type": "string",
"description": "Search engine to get history for (required -- history is always single-engine)"
},
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
},
"end_date": {
"type": "string",
"description": "End of the range, inclusive, as YYYY-MM-DD"
},
"dimension": {
"enum": [
"total",
"device"
],
"type": "string",
"description": "Breakdown of the daily rows. Default \"total\" is one row per day; \"device\" is one row per day per device (desktop/mobile/tablet) with a device field on each row. Device rows exist only where the provider synced them (always for Google; Yandex only when its device breakdown is enabled), so an empty device history for a keyword with total history means \"not synced per-device\", not \"no traffic\"."
},
"keyword_id": {
"type": "string",
"description": "Tracked keyword ID, from list_tracked_keywords"
},
"start_date": {
"type": "string",
"description": "Start of the range, inclusive, as YYYY-MM-DD"
}
},
"additionalProperties": false
}Get stored ranking summaries (current vs previous period) for a website's tracked keywords across Google, Bing, and Yandex. Reads RankParse snapshots synced on a schedule; it is not a live SERP check. Positions are provider-reported averages over each engine's own returned period and are NOT comparable as one blended rank across engines -- compare per engine, not by averaging across them. A missing engine in a keyword's response means that engine is not connected/attached for this site (check enabled_engines in the response), not a zero or bottom rank. Bing and Yandex are opt-in and many accounts do not have them connected, so their absence is normal, not an error. Each present engine also carries an availability field; a null current/previous position with availability other than "available" (e.g. provider_limited, which Bing/Yandex may report, or pending_first_sync, stale, sync_failed) means a data quality/sync issue for that engine, not evidence the keyword ranks nowhere.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max keywords to return (default 100, max 100) |
| engine | string | Search engine to report on. Defaults to "all" (every engine enabled for this account) -- the primary use case is comparing engines side by side, so leave this unset unless you need one engine only. |
| offset | integer | Pagination offset (default 0) |
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
| keyword_id | string | Restrict to one tracked keyword ID, from list_tracked_keywords. Omit to get all keywords for the site. |
| period_days | integer | Length of the current/previous comparison window in days (default 28, max 90) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max keywords to return (default 100, max 100)"
},
"engine": {
"enum": [
"all",
"google",
"bing",
"yandex"
],
"type": "string",
"description": "Search engine to report on. Defaults to \"all\" (every engine enabled for this account) -- the primary use case is comparing engines side by side, so leave this unset unless you need one engine only."
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Pagination offset (default 0)"
},
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
},
"keyword_id": {
"type": "string",
"description": "Restrict to one tracked keyword ID, from list_tracked_keywords. Omit to get all keywords for the site."
},
"period_days": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "Length of the current/previous comparison window in days (default 28, max 90)"
}
},
"additionalProperties": false
}Audit a domain's backlink profile: health score, risk flags, link quality breakdown, anchor text profile, top and risky backlinks, and outbound link summary. Scores are derived from a sample of the 250 most recent backlinks, not the full profile.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Find domains linking to A but not B
| Argument | Type | Description |
|---|---|---|
| domain_a* | string | |
| domain_b* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain_a",
"domain_b"
],
"properties": {
"domain_a": {
"type": "string"
},
"domain_b": {
"type": "string"
}
},
"additionalProperties": false
}Get rate of new/lost links over time (v1 stub)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get links lost since previous crawl (v1 stub)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get links gained since previous crawl (v1 stub)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get domains that a domain links out to
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Google PageSpeed Insights report for a URL: Lighthouse performance/accessibility/SEO scores and Core Web Vitals (LCP, CLS, INP, FCP, TTFB), with lab and field (CrUX) data. Defaults to mobile; pass strategy=desktop for the desktop profile. Subject to a per-user daily cap (50/day) and a service-wide daily cap; successful responses are cached for 24h.
| Argument | Type | Description |
|---|---|---|
| url* | string | |
| strategy | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
},
"strategy": {
"enum": [
"mobile",
"desktop"
],
"type": "string"
}
},
"additionalProperties": false
}Full real-time SEO audit for a URL: title/description with length checks, canonical, robots meta, OG tags, Twitter cards, JSON-LD, hreflang, headings, images missing alt, link counts, word count
| Argument | Type | Description |
|---|---|---|
| url* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
},
"additionalProperties": false
}Get all domains running a specific platform or technology (e.g. WordPress, Shopify, Wix, Squarespace, Framer). Returns domains with DA scores. Billed at 1 credit per result returned.
| Argument | Type | Description |
|---|---|---|
| tld | string | Filter by top-level domain (e.g. "com", "io", "co.uk") |
| sort | string | Sort order: da_desc (default), da_asc, domain_asc |
| limit | number | Max results to return (default 100, max 1000) |
| max_da | number | Maximum domain authority score (0–100) |
| min_da | number | Minimum domain authority score (0–100) |
| platform* | string | Platform name or slug (e.g. "wordpress", "shopify", "wix", "squarespace", "framer") |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"platform"
],
"properties": {
"tld": {
"type": "string",
"description": "Filter by top-level domain (e.g. \"com\", \"io\", \"co.uk\")"
},
"sort": {
"enum": [
"da_desc",
"da_asc",
"domain_asc"
],
"type": "string",
"description": "Sort order: da_desc (default), da_asc, domain_asc"
},
"limit": {
"type": "number",
"description": "Max results to return (default 100, max 1000)"
},
"max_da": {
"type": "number",
"description": "Maximum domain authority score (0–100)"
},
"min_da": {
"type": "number",
"description": "Minimum domain authority score (0–100)"
},
"platform": {
"type": "string",
"description": "Platform name or slug (e.g. \"wordpress\", \"shopify\", \"wix\", \"squarespace\", \"framer\")"
}
},
"additionalProperties": false
}Get a ranked list of all detectable platforms and technologies with their domain counts, useful for comparing platform adoption (e.g. how many sites run WordPress vs Shopify)
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get the rank-change alert configuration for one RankParse website: whether weekly alert digests are enabled (they are opt-in and default off), the moved_up/moved_down position threshold, and the optional digest email override. Delivery is Sunday at 18:00 UTC when meaningful changes exist.
| Argument | Type | Description |
|---|---|---|
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
}
},
"additionalProperties": false
}Get unique domains linking to a domain
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| score | boolean | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"score": {
"type": "boolean"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Extract schema.org JSON-LD structured data from a URL: every entity found (including ones nested in @graph), their types, and any malformed blocks
| Argument | Type | Description |
|---|---|---|
| url* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
},
"additionalProperties": false
}Find domains with similar link profiles, useful for competitor discovery. May return partial results when the query fan-out hits time budget.
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Full SEO overview for a domain (backlinks, authority, top pages, anchor text)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Real-time site health check: HTTPS enforcement, HSTS, www redirect behavior, key URL availability and response times, security headers (CSP, X-Frame-Options, HSTS), robots.txt analysis
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Discover and parse a domain's sitemap. Returns URLs with lastmod, changefreq, and priority
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Real-time technology detection for a domain: frameworks, CMS, analytics, CDN, hosting, e-commerce, payments, and more (50+ technologies)
| Argument | Type | Description |
|---|---|---|
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
},
"additionalProperties": false
}Get most-linked pages for a domain
| Argument | Type | Description |
|---|---|---|
| limit | number | |
| domain* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"limit": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": false
}List actions you or RankParse proposed and their status (pending, approved, succeeded, failed, skipped, expired). Use it to see what the user approved or skipped. A failed or partly failed proposal carries an error_code, for example nothing_to_send (everything was already queued or suppressed), payload_changed_since_approval (it changed after approval, so propose again) or approver_lost_permission (tell the user).
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| status | string | |
| site_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"status": {
"enum": [
"pending",
"approved",
"executing",
"succeeded",
"partially_succeeded",
"failed",
"skipped",
"expired",
"superseded",
"cancelled"
],
"type": "string"
},
"site_id": {
"type": "string"
}
},
"additionalProperties": false
}List recent rank-change alert events for one RankParse website: significant stored-ranking moves (entered/left top 3 or top 10, moved up/down past the configured threshold, new/lost rankings) detected daily and summarized in a weekly email. Reads recorded events, never runs a live check; a keyword with no events simply had no significant moves. Events exist only while alerts are enabled for the site (see get_rank_alert_settings) and only for engines whose data was actually available -- provider-limited or pending engines generate nothing rather than false "lost ranking" alerts.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max events to return (default 100, max 100) |
| offset | integer | Pagination offset (default 0) |
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max events to return (default 100, max 100)"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Pagination offset (default 0)"
},
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
}
},
"additionalProperties": false
}List websites configured for stored Google, Bing, and Yandex keyword tracking, including provider freshness and sync state. This reads RankParse snapshots; it does not run a live SERP check.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}List the tracked keyword IDs and text for one RankParse website. Call list_rank_tracking_sites first to obtain site_id.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max keywords to return (default 100, max 100) |
| offset | integer | Pagination offset (default 0) |
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Max keywords to return (default 100, max 100)"
},
"offset": {
"type": "integer",
"minimum": 0,
"description": "Pagination offset (default 0)"
},
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
}
},
"additionalProperties": false
}List this account's websites (id, host, name). Use the id as site_id in propose_* and log_activity. At the start of any RankParse session, call get_agent_tasks to see work the user queued for you.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Record what you did for the user in their RankParse activity feed, in plain text (max 500 characters). Credits are taken from your recent RankParse calls automatically; do not report credits yourself. Pass client_request_id to make retries safe.
| Argument | Type | Description |
|---|---|---|
| site_id | string | |
| summary* | string | |
| kind_hint | string | |
| client_request_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"summary"
],
"properties": {
"site_id": {
"type": "string"
},
"summary": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"kind_hint": {
"enum": [
"research",
"draft",
"analysis"
],
"type": "string"
},
"client_request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$"
}
},
"additionalProperties": false
}Add contacts with per-contact email copy to a campaign (max 100 per call, 500 per campaign, one contact per domain). Works on a draft campaign AND on an already-launched one, which is how you top a live campaign up with fresh prospects. Each contact needs a researched, real email address (never guess addresses) plus a personalized subject and plain-text body (subject ≤500 chars, body ≤10,000). Write like a human: plain punctuation, and NEVER use em-dashes in subjects or bodies. Subjects must be 2-5 words that read like a note from a colleague and reference their content (e.g. "your AI tools guide"): never sales words like exclusive, lifetime, revenue, or deal. Internationalized (non-ASCII) domains must be given in punycode (xn--) form. Returns how many were added and which were skipped (invalid email, duplicate domain/email, copy too long, campaign full, already_contacted = this person was emailed in an earlier campaign). Contacts added to a launched campaign sit inert until you call outreach_launch_campaign again. A contact already in the campaign is skipped as duplicate_email or duplicate_domain and its copy is NOT changed: to rewrite the copy of existing contacts use outreach_update_contacts, do not create a new campaign.
| Argument | Type | Description |
|---|---|---|
| contacts* | array | Contacts with their personalized copy |
| campaign_id* | string | Campaign id from outreach_create_campaign |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id",
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"email",
"domain",
"subject",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Personalized plain-text email body"
},
"name": {
"type": "string",
"description": "Contact name if known"
},
"email": {
"type": "string",
"description": "Contact email address (researched, not guessed)"
},
"domain": {
"type": "string",
"description": "The prospect domain this contact belongs to"
},
"subject": {
"type": "string",
"description": "Personalized email subject"
},
"domain_authority": {
"type": "number",
"description": "Domain authority 0-100 if you already looked it up, for sorting and stats. Out-of-range values are stored as unknown rather than rejected."
}
},
"additionalProperties": false
},
"description": "Contacts with their personalized copy"
},
"campaign_id": {
"type": "string",
"description": "Campaign id from outreach_create_campaign"
}
},
"additionalProperties": false
}Update the Gmail sending schedule of ONE mailbox (the workspace default unless you pass mailbox_id from outreach_sending_status; each mailbox has its own cap and switch): max_sends_per_day (1-100, shared by the campaigns that send from that mailbox) and/or auto_send_enabled (false stops all sending from that mailbox, true resumes it). Lowering the cap or turning sending off applies immediately. For most accounts, raising the cap or turning sending on needs the user's approval in RankParse: the response is 202 with ok true, status awaiting_approval and a review_url, and nothing has been increased yet, so show the user the review_url. For other accounts a raise applies directly and returns ok true. A request that mixes both applies the decrease or disable now and proposes the rest; the message then starts "Applied now: ...". If it fails with change_in_progress, another sending change is already approved or running. The increase was not applied, but any decrease or disable in the same request has been applied (see applied and message): send the increase again after it completes (check list_proposals). If status is approved, it is already approved; do not ask again. Confirm with the user before changing these; they control real email volume.
| Argument | Type | Description |
|---|---|---|
| mailbox_id | string | A mailbox_id from outreach_sending_status. Omit it for the workspace default mailbox. |
| auto_send_enabled | boolean | Master switch for the hourly send sweep of the mailbox |
| max_sends_per_day | integer | Daily send cap for the mailbox (1-100) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mailbox_id": {
"type": "string",
"description": "A mailbox_id from outreach_sending_status. Omit it for the workspace default mailbox."
},
"auto_send_enabled": {
"type": "boolean",
"description": "Master switch for the hourly send sweep of the mailbox"
},
"max_sends_per_day": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Daily send cap for the mailbox (1-100)"
}
},
"additionalProperties": false
}Create a draft link-building outreach campaign (sends via the user's connected Gmail). Outreach flow: 1) interview the user (their site, goal, competitors), 2) build a prospect list with get_competitor_gap / get_referring_domains / get_domain_authority, 3) research one real contact email per prospect domain, 4) write a short personalized subject+body per contact, 5) outreach_create_campaign, 6) outreach_add_contacts, 7) show the user the emails you drafted and get their OK before launching, 8) outreach_launch_campaign: this tells RankParse the campaign is ready and returns status ready_for_review with a review_url (the campaign page), and nothing is sent until the user approves the emails there one by one; tell the user it is ready to review in RankParse and share the review_url (if status is approved it is already approved, so do not launch again). Shortcut: propose_outreach_send does steps 5, 6 and 8 in one call (creates or tops up the campaign, adds the contacts, marks it ready for review). Requires the user to have Gmail connected at rankparse.com/dashboard/integrations. To CONTINUE an existing campaign rather than start a new one, begin at outreach_suggest_prospects instead of step 1: campaigns are topped up, not replaced. To change the email copy of contacts already in a campaign (for example when the user asks for a rewrite), call outreach_update_contacts on the SAME campaign and then outreach_launch_campaign again; never create a second campaign for that, because the first one would keep its old unsent emails.
| Argument | Type | Description |
|---|---|---|
| goal | string | What the outreach is trying to achieve, for the campaign record |
| name* | string | Campaign name, e.g. "SaaS blogs - competitor gap Aug 2026" |
| site_id | string | Optional RankParse website id (from list_websites, or given to you in a website-scoped outreach prompt) to link this campaign to a website. Omit to leave it unassigned. |
| your_domain* | string | The domain being promoted, e.g. "example.com" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"your_domain"
],
"properties": {
"goal": {
"type": "string",
"description": "What the outreach is trying to achieve, for the campaign record"
},
"name": {
"type": "string",
"description": "Campaign name, e.g. \"SaaS blogs - competitor gap Aug 2026\""
},
"site_id": {
"type": "string",
"description": "Optional RankParse website id (from list_websites, or given to you in a website-scoped outreach prompt) to link this campaign to a website. Omit to leave it unassigned."
},
"your_domain": {
"type": "string",
"description": "The domain being promoted, e.g. \"example.com\""
}
},
"additionalProperties": false
}Get a campaign's status and delivery counts (awaiting launch, queued, sending, sent, skipped). Use to answer "how is my campaign doing?".
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id"
}
},
"additionalProperties": false
}Tell RankParse a campaign's emails are ready. It returns status ready_for_review with a review_url (the campaign page): the user reviews and approves each email there, and nothing is sent until they do. Only if the user turned on "Let Claude send without review" in RankParse does it queue the emails directly (queued/suppressed counts). Safe to call again; it never re-sends. When it returns ready_for_review, tell the user the emails are ready to review in RankParse and show them the review_url. If status is approved, it is already approved; do not launch again. If it returns queued/suppressed counts instead of ready_for_review, the emails are being sent now, so only call it after the user has seen the drafted emails and explicitly approved sending.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id to launch |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id to launch"
}
},
"additionalProperties": false
}List this account's outreach campaigns with status and contact counts. Optionally filter to one website; an unknown site_id returns an empty list.
| Argument | Type | Description |
|---|---|---|
| site_id | string | Optional RankParse website id (from list_websites) to list only that website's campaigns |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"site_id": {
"type": "string",
"description": "Optional RankParse website id (from list_websites) to list only that website's campaigns"
}
},
"additionalProperties": false
}Pause one campaign: its queued emails stop sending but stay queued, so resuming continues exactly where it left off. Other campaigns keep sending.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id to pause |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id to pause"
}
},
"additionalProperties": false
}Resume a paused campaign; its queued emails become eligible for the next hourly send sweep again.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id to resume |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id to resume"
}
},
"additionalProperties": false
}Get the Gmail sending status of one mailbox (the workspace default, or the one named by mailbox_id): connected account, auto-send on/off, daily cap, how many sent today, remaining budget today, how many emails it has queued, and estimated days to drain them. It also returns mailboxes: every connected Gmail mailbox with its own account, cap and queue. Each website sends from the mailbox it is mapped to, or from the default one.
| Argument | Type | Description |
|---|---|---|
| mailbox_id | string | A mailbox_id from the mailboxes list. Omit it for the workspace default mailbox. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mailbox_id": {
"type": "string",
"description": "A mailbox_id from the mailboxes list. Omit it for the workspace default mailbox."
}
},
"additionalProperties": false
}START HERE when adding more websites to an existing campaign. Returns the campaign's own context (domain, goal), how much room it has left, its send queue, and — critically — exclude_domains: every prospect domain this account has already used in ANY campaign. You MUST filter your discovery results against exclude_domains. get_competitor_gap is cached and unpaginated, so calling it again returns the identical top-N: request a limit several times larger than recommended_batch_size, drop everything already in exclude_domains, and keep what is left. Widen the pool with get_similar_domains, get_link_intersect, or get_platform_domains when the competitor gap is exhausted. Then research one real contact per surviving domain, call outreach_add_contacts, and finish with outreach_launch_campaign to queue them. Note exclude_domains_truncated: when true the list is capped and you should prefer clearly-unseen domains.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id to top up |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id to top up"
}
},
"additionalProperties": false
}Rewrite the subject and body of contacts that are already in a campaign, in that same campaign (max 100 per call). Use this when the user asks to change or redo email copy; do NOT create a new campaign for that, and do not try outreach_add_contacts, which skips contacts the campaign already holds. Contacts are matched by email address; the address itself never changes. Only emails still waiting for review (the awaiting_launch count in outreach_get_campaign) are rewritten, and any approval they had is cleared so the user reviews the new copy. Emails that are queued, sending, sent or skipped come back as not_editable and are left exactly as they were: if a queued email should change too, ask the user to take it back to review in RankParse (Unapprove), then call this again; a sent email cannot change and a skipped one must be restored in RankParse first. Same copy rules as outreach_add_contacts: plain punctuation, NEVER use em-dashes, subject 2-5 words that reads like a note from a colleague, subject ≤500 chars, body ≤10,000. Returns one result per contact (updated, not_found, not_editable with the state it is in, or invalid with the reason). After updating, call outreach_launch_campaign again so the rewritten emails go back to the user for review.
| Argument | Type | Description |
|---|---|---|
| contacts* | array | Contacts with their new copy |
| campaign_id* | string | Campaign id the contacts are already in |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id",
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"email",
"subject",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "New personalized plain-text email body"
},
"email": {
"type": "string",
"description": "Email address of a contact already in the campaign"
},
"subject": {
"type": "string",
"description": "New personalized email subject"
}
},
"additionalProperties": false
},
"description": "Contacts with their new copy"
},
"campaign_id": {
"type": "string",
"description": "Campaign id the contacts are already in"
}
},
"additionalProperties": false
}Ask the user to approve submitting URLs to IndexNow (Bing, Yandex, Seznam, Naver). All URLs on one host that is one of the user's websites, max 1000. Costs 1 credit only when it runs. If status is approved, it is already approved; do not propose it again. Nothing happens until the user approves it in RankParse (unless they allowed it in website settings). Show them the review_url.
| Argument | Type | Description |
|---|---|---|
| note | string | Why, in one or two plain sentences. Shown to the user labelled as your note. |
| urls* | array | |
| site_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"urls"
],
"properties": {
"note": {
"type": "string",
"maxLength": 1000,
"description": "Why, in one or two plain sentences. Shown to the user labelled as your note."
},
"urls": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 1000,
"minItems": 1
},
"site_id": {
"type": "string"
}
},
"additionalProperties": false
}Put outreach emails in front of the user for review. Pass contacts inline (max 100, one per domain, researched real addresses, personalized subject and plain-text body, no em-dashes). RankParse creates or tops up the draft campaign and marks it ready: the user reviews and approves each email on the campaign page (the review_url), and nothing is sent until they do. Use site_id from list_websites (required when creating a campaign; with campaign_id it must match that campaign's website). To propose the copy-ready contacts a campaign already has, pass campaign_id without contacts. If status is approved, it is already approved; do not propose it again. Nothing is sent until the user approves it in RankParse. Show them the review_url.
| Argument | Type | Description |
|---|---|---|
| note | string | Why, in one or two plain sentences. Shown to the user labelled as your note. |
| site_id | string | Website id from list_websites. Required when campaign_id is omitted |
| contacts | array | Required when campaign_id is omitted |
| campaign_id | string | Existing campaign to top up; omit to create one |
| campaign_name | string | Required when campaign_id is omitted |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"note": {
"type": "string",
"maxLength": 1000,
"description": "Why, in one or two plain sentences. Shown to the user labelled as your note."
},
"site_id": {
"type": "string",
"description": "Website id from list_websites. Required when campaign_id is omitted"
},
"contacts": {
"type": "array",
"items": {
"type": "object",
"required": [
"email",
"domain",
"subject",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 10000
},
"name": {
"type": "string",
"maxLength": 200
},
"email": {
"type": "string",
"maxLength": 320
},
"domain": {
"type": "string",
"maxLength": 253
},
"subject": {
"type": "string",
"maxLength": 500
},
"domain_authority": {
"type": "number"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1,
"description": "Required when campaign_id is omitted"
},
"campaign_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Existing campaign to top up; omit to create one"
},
"campaign_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Required when campaign_id is omitted"
}
},
"additionalProperties": false
}Get (or create) the IndexNow key for a host. Idempotent per host: repeated calls return the same key. Free (0 credits). Returns the key, its required key_location (https://<host>/<key>.txt), and verified (whether the hosted key file has already been confirmed). The USER must host a UTF-8 text file containing exactly the key at key_location before submit_indexnow_urls will work — tell them the location and the key, then submit.
| Argument | Type | Description |
|---|---|---|
| domain* | string | The website host to provision a key for, e.g. "example.com" |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "The website host to provision a key for, e.g. \"example.com\""
}
},
"additionalProperties": false
}Submit changed/new/deleted URLs to IndexNow so search engines (Bing, Yandex, Seznam, Naver, ...) recrawl them promptly. All URLs must share one host, max 1000 per call. Requires the host's IndexNow key file to be live: call provision_indexnow_key first and make sure the user hosted the key file at its key_location (indexnow_key_not_verified means the file is missing or wrong). Costs 1 credit, refunded automatically when the submission fails.
| Argument | Type | Description |
|---|---|---|
| urls* | array | Full URLs to submit, e.g. ["https://example.com/a", "https://example.com/b"] — all on the same host |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"urls"
],
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Full URLs to submit, e.g. [\"https://example.com/a\", \"https://example.com/b\"] — all on the same host"
}
},
"additionalProperties": false
}Update rank-change alert settings for one RankParse website: enable/disable the weekly digest (opt-in, default off), set the moved_up/moved_down position threshold (1-50, default 5), or set/clear an email override for that site's digest lines (null reverts to the account email). Only the fields you pass change. Confirm with the user before enabling -- this turns on a real weekly email when meaningful changes exist.
| Argument | Type | Description |
|---|---|---|
| enabled | boolean | Turn the weekly alert digest on or off for this site |
| site_id* | string | Logical RankParse website ID, from list_rank_tracking_sites |
| email_override | string | null | Email address to send this site's digest lines to instead of the account email; null clears it |
| move_threshold | number | Average-position delta that counts as moved_up/moved_down (default 5) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"site_id"
],
"properties": {
"enabled": {
"type": "boolean",
"description": "Turn the weekly alert digest on or off for this site"
},
"site_id": {
"type": "string",
"description": "Logical RankParse website ID, from list_rank_tracking_sites"
},
"email_override": {
"type": [
"string",
"null"
],
"description": "Email address to send this site's digest lines to instead of the account email; null clears it"
},
"move_threshold": {
"type": "number",
"maximum": 50,
"minimum": 1,
"description": "Average-position delta that counts as moved_up/moved_down (default 5)"
}
},
"additionalProperties": false
}Activates a paused Zeekeo campaign so it starts running (sends real LinkedIn connection invites per the campaign's configured limit/delay). Zeekeo campaigns are created paused by default — call this after zeekeo_create_campaign to actually start sending. This resumes REAL LinkedIn automation — confirm with the user before calling. Requires the user to have connected their own Zeekeo Launchpad account. Direct them to rankparse.com/dashboard/integrations to connect it.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Zeekeo campaign id from zeekeo_list_campaigns or zeekeo_create_campaign |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Zeekeo campaign id from zeekeo_list_campaigns or zeekeo_create_campaign"
}
},
"additionalProperties": false
}Creates a Zeekeo LinkedIn campaign: sends a connection invite using invite_template_id, and optionally — if followup_template_id is given — waits for the invite to be accepted, then sends a follow-up message using that template. Create templates first with zeekeo_create_template. Provide exactly one of filter_url (a LinkedIn search results URL) or profile_urls (specific profiles) as the target. This starts REAL LinkedIn automation once the campaign has profiles in it — confirm with the user before calling. Requires the user to have connected their own Zeekeo Launchpad account. Direct them to rankparse.com/dashboard/integrations to connect it.
| Argument | Type | Description |
|---|---|---|
| name* | string | Campaign name |
| filter_url | string | A LinkedIn search results URL to source profiles from. Provide this or profile_urls, not both. |
| invite_delay | number | Seconds to wait before the first invite (default 0) |
| invite_limit | number | Max invites to send (default 20) |
| profile_urls | array | Specific LinkedIn profile URLs to target. Provide this or filter_url, not both. |
| invite_template_id* | string | Template id from zeekeo_create_template (type linkedin_invite) |
| followup_delay_hours | number | Hours to wait after connection before the follow-up (default 24) |
| followup_template_id | string | Template id from zeekeo_create_template (type linkedin_message) for a follow-up message sent after the invite is accepted. Omit for an invite-only campaign. Must be a linkedin_message template — email_message and linkedin_inmail templates are not valid here. |
| exclude_past_campaigns_targets | boolean | Skip people already targeted in a previous campaign (default true) |
| exclude_first_degree_connections | boolean | Skip people already connected to the user (default true) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"invite_template_id"
],
"properties": {
"name": {
"type": "string",
"description": "Campaign name"
},
"filter_url": {
"type": "string",
"description": "A LinkedIn search results URL to source profiles from. Provide this or profile_urls, not both."
},
"invite_delay": {
"type": "number",
"description": "Seconds to wait before the first invite (default 0)"
},
"invite_limit": {
"type": "number",
"description": "Max invites to send (default 20)"
},
"profile_urls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Specific LinkedIn profile URLs to target. Provide this or filter_url, not both."
},
"invite_template_id": {
"type": "string",
"description": "Template id from zeekeo_create_template (type linkedin_invite)"
},
"followup_delay_hours": {
"type": "number",
"description": "Hours to wait after connection before the follow-up (default 24)"
},
"followup_template_id": {
"type": "string",
"description": "Template id from zeekeo_create_template (type linkedin_message) for a follow-up message sent after the invite is accepted. Omit for an invite-only campaign. Must be a linkedin_message template — email_message and linkedin_inmail templates are not valid here."
},
"exclude_past_campaigns_targets": {
"type": "boolean",
"description": "Skip people already targeted in a previous campaign (default true)"
},
"exclude_first_degree_connections": {
"type": "boolean",
"description": "Skip people already connected to the user (default true)"
}
},
"additionalProperties": false
}Creates a reusable Zeekeo message template. Call this BEFORE zeekeo_create_campaign — a campaign references templates by the template_id this returns, not inline text. type must be 'linkedin_invite' for a connection-request template, or one of linkedin_message/linkedin_inmail/email_message for a follow-up/reply template. Requires the user to have connected their own Zeekeo Launchpad account. Direct them to rankparse.com/dashboard/integrations to connect it.
| Argument | Type | Description |
|---|---|---|
| body* | string | Message text. Supports Zeekeo merge variables like {{FIRST_NAME}} and {{COMPANY}}. |
| name* | string | Template name, for your own reference in the Zeekeo dashboard |
| type* | string | What kind of message this template is for |
| subject | string | Subject line, required when type is email_message |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"type",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Message text. Supports Zeekeo merge variables like {{FIRST_NAME}} and {{COMPANY}}."
},
"name": {
"type": "string",
"description": "Template name, for your own reference in the Zeekeo dashboard"
},
"type": {
"enum": [
"linkedin_invite",
"linkedin_message",
"linkedin_inmail",
"email_message"
],
"type": "string",
"description": "What kind of message this template is for"
},
"subject": {
"type": "string",
"description": "Subject line, required when type is email_message"
}
},
"additionalProperties": false
}List the user's Zeekeo Launchpad campaigns (LinkedIn automation). Use this to find a campaign_id for zeekeo_send_message, or call zeekeo_create_campaign to make a new one. Requires the user to have connected their own Zeekeo Launchpad account. Direct them to rankparse.com/dashboard/integrations to connect it.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Sends a REAL LinkedIn message, InMail, or email through Zeekeo Launchpad to a profile in one of the user's existing Zeekeo campaigns. Only call this after showing the user the drafted message and getting explicit approval. Resolves linkedin_url into that campaign first, so the profile must be reachable from it (use zeekeo_list_campaigns to pick campaign_id). Requires the user to have connected their own Zeekeo Launchpad account. Direct them to rankparse.com/dashboard/integrations to connect it.
| Argument | Type | Description |
|---|---|---|
| body* | string | Message text |
| type* | string | Channel to send through |
| subject | string | Subject line, required when type is email_message |
| campaign_id* | string | Zeekeo campaign id from zeekeo_list_campaigns |
| linkedin_url* | string | LinkedIn profile URL or public identifier of the recipient |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"campaign_id",
"linkedin_url",
"type",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Message text"
},
"type": {
"enum": [
"linkedin_message",
"linkedin_inmail",
"email_message"
],
"type": "string",
"description": "Channel to send through"
},
"subject": {
"type": "string",
"description": "Subject line, required when type is email_message"
},
"campaign_id": {
"type": "string",
"description": "Zeekeo campaign id from zeekeo_list_campaigns"
},
"linkedin_url": {
"type": "string",
"description": "LinkedIn profile URL or public identifier of the recipient"
}
},
"additionalProperties": false
}