The OpenSEO MCP connector routes your AI agent's tool calls to OpenSEO's own MCP server through Scalekit. Each user signs in to OpenSEO once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 46 tools.
- Tools
- 46
- What they doRead · write · destructive
- 21 · 22 · 321 read22 write3 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the OpenSEO MCP connection
In AgentKit > Connections, create an OpenSEO MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for OpenSEO MCP server, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'openseomcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize OpenSEO MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'openseomcp_whoami',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "openseomcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize OpenSEO MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="openseomcp_whoami",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolopenseomcp_estimate_rank_tracker_costEstimate rank tracker cost without spending credits or starting a check.Read-onlyEstimate Rank Tracker Cost
Estimate rank tracker cost without spending credits or starting a check. The live estimate covers one explicit run_rank_tracker check. For a scheduled tracker, the response also includes nominal queued per-check and approximate monthly recurring cost. Pass additionalKeywordCount before adding keywords to project the post-add cost. Scheduled estimates are not runtime caps; rejected, failed, or timed-out queued tasks may use additional separately billed live fallback.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
trackerIdstringrequired- Rank tracker ID from get_rank_tracker.
additionalKeywordCountinteger- Number of keywords you plan to add. Include this before adding to a scheduled tracker so the response projects its recurring per-check and monthly cost.
openseomcp_get_audit_issuesRead the prioritized issue report from a completed site audit.Read-onlyGet site audit issues
Read the prioritized issue report from a completed site audit. Every issue carries a how_to_fix with concrete remediation steps an agent can act on. Free — reads OpenSEO state. Omit auditId for the most recent audit.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
auditIdstring- ID of the audit to read issues from. If omitted, uses the project's most recent audit. Example: audit_5f3a1b2c.
issueTypestring- Only return issues of this type, such as broken-internal-link, duplicate-title, thin-content, or redirect-chain. See the enum for the full list of recognized issue types. Leave blank to return every type.one of
blocked-pagerate-limited-pagecrawl-rate-limitedserver-errorbroken-internal-linkmissing-titlebroken-pageduplicate-titleduplicate-meta-descriptionduplicate-contentmissing-meta-descriptionmissing-h1multiple-h1redirect-chainredirect-loopcanonical-conflictthin-contentimages-missing-altorphan-pageno-outgoing-linkstitle-too-longtitle-too-shortmeta-description-too-longmeta-description-too-shortheading-order-skipslow-responsenoindex-pagecanonicalized-pagedeep-page limitinteger- Maximum number of issues to return, between 1 and 1000. Defaults to 200.default
200 severitystring- Only return issues at this severity level: critical, warning, or info. Leave blank to return issues of every severity.one of
criticalwarninginfo
openseomcp_get_audit_pagesList crawled pages from a site audit with per-page SEO data (status, title, description, word count, indexability, crawl depth, link counts).Read-onlyGet site audit pages
List crawled pages from a site audit with per-page SEO data (status, title, description, word count, indexability, crawl depth, link counts). Free — reads OpenSEO state. Omit auditId for the most recent audit.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
auditIdstring- ID of the audit to list pages from. If omitted, uses the project's most recent audit. Example: audit_5f3a1b2c.
fetchClassstring- Filter by fetch outcome: ok, blocked (the site's bot protection challenged the crawler), rate_limited (a 429 prevented the crawler from reading the page), or error. Leave blank to return pages of every fetch outcome.one of
okblockedrate_limitederror limitinteger- Maximum number of pages to return, between 1 and 1000. Defaults to 100.default
100 statusCodeinteger- Filter to pages that returned exactly this HTTP status code. Example: 404.
urlContainsstring- Filter to page URLs containing this substring (case-sensitive). Example: /blog/.
openseomcp_get_google_analytics_audience_breakdownRead device, country, or new-versus-returning users, sessions, engagement, and key events.Read-onlyGet Google Analytics audience breakdown
Read device, country, or new-versus-returning users, sessions, engagement, and key events. Previous-period comparison is available for device and new-versus-returning breakdowns. No demographic or user-level dimensions. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
breakdownstring- How to group audience data: device (default; desktop/mobile/tablet), country, or new_vs_returning (new versus returning users). Previous-period comparison is available for device and new_vs_returning. Defaults to device.one of
devicecountrynew_vs_returningdefaultdevice channelstring- Which acquisition channel to scope the audience data to: organic_search (default) or all channels.one of
organic_searchalldefaultorganic_search comparePreviousPeriodboolean- When true, adds previous-period comparison values alongside the current period's metrics. Only available when Breakdown is device or new_vs_returning Defaults to false.default
false endDatestring- Inclusive end date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with startDate. Example: 2026-08-31.
limitinteger- Maximum number of rows to return, between 1 and 1000. Defaults to 100.default
100 offsetinteger- Number of rows to skip before the first row returned, for paging through results beyond limit. Defaults to 0.default
0 startDatestring- Inclusive start date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with endDate; when both are omitted OpenSEO falls back to its standard recent date range. Example: 2026-08-01.
openseomcp_get_google_analytics_ecommerce_performanceRead item views, add-to-cart units, purchases, and item revenue by item, or transactions and purchase revenue by landing page.Read-onlyGet Google Analytics ecommerce performance
Read item views, add-to-cart units, purchases, and item revenue by item, or transactions and purchase revenue by landing page. Returns a detected, none, or unknown activity state; landing pages can be limited to those with transactions. Organic Search is the default. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
breakdownstring- How to group ecommerce performance data: item (item views, add-to-cart units, purchases, and item revenue per item) or landing_page (transactions and purchase revenue per landing page). Defaults to item.one of
itemlanding_pagedefaultitem channelstring- Which acquisition channel to scope the ecommerce data to: organic_search (default) or all channels.one of
organic_searchalldefaultorganic_search endDatestring- Inclusive end date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with startDate. Example: 2026-08-31.
limitinteger- Maximum number of rows to return, between 1 and 1000. Defaults to 100.default
100 offsetinteger- Number of rows to skip before the first row returned, for paging through results beyond limit. Defaults to 0.default
0 onlyWithTransactionsboolean- When true and Breakdown is landing_page, limits results to landing pages that recorded at least one transaction. Defaults to false.default
false startDatestring- Inclusive start date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with endDate; when both are omitted OpenSEO falls back to its standard recent date range. Example: 2026-08-01.
openseomcp_get_google_analytics_key_eventsRead active GA4 key events with counts and users by event or organic landing page.Read-onlyGet Google Analytics key events
Read active GA4 key events with counts and users by event or organic landing page. Previous-period comparison is available for the event breakdown. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
breakdownstring- How to group key-event rows. Defaults to event.one of
eventevent_and_landing_pagedefaultevent channelstring- Traffic channel to filter to. Defaults to organic_search.one of
organic_searchalldefaultorganic_search comparePreviousPeriodboolean- Include a comparison against the immediately preceding period of equal length. Only applies to the event breakdown. Defaults to false.default
false endDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
limitinteger- Maximum number of key-event rows to return. Defaults to 100.default
100 offsetinteger- Number of rows to skip, for pagination. Defaults to 0.default
0 startDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
openseomcp_get_google_analytics_measurement_healthDiagnose the connected property's data streams, web measurement IDs, enhanced-measurement settings, key events, and custom definitions.Read-onlyGet Google Analytics measurement health
Diagnose the connected property's data streams, web measurement IDs, enhanced-measurement settings, key events, and custom definitions. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
openseomcp_get_google_analytics_organic_landing_pagesRead organic-search landing page sessions, engagement, key events, transactions, and revenue from the project's connected GA4 property.Read-onlyGet Google Analytics organic landing pages
Read organic-search landing page sessions, engagement, key events, transactions, and revenue from the project's connected GA4 property. Defaults to the last 28 complete property days. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
endDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
limitinteger- Maximum number of landing-page rows to return. Defaults to 100.default
100 offsetinteger- Number of rows to skip, for pagination. Defaults to 0.default
0 startDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
openseomcp_get_google_analytics_organic_overviewAnswer whether organic traffic is improving with top-line sessions, users, engagement, key events, transactions, revenue, an equal-length previous-period comparison, and a daily or weekly trend.Read-onlyGet Google Analytics organic overview
Answer whether organic traffic is improving with top-line sessions, users, engagement, key events, transactions, revenue, an equal-length previous-period comparison, and a daily or weekly trend. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
endDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
startDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
trendstring- Granularity of the trend series returned alongside the summary. Defaults to daily.one of
dailyweeklydefaultdaily
openseomcp_get_google_analytics_page_performanceRead page views, users, engagement duration, and key events from the connected GA4 property.Read-onlyGet Google Analytics page performance
Read page views, users, engagement duration, and key events from the connected GA4 property. Organic Search is the default; set channel to all to include every channel. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
channelstring- Traffic channel to filter to. Defaults to organic_search.one of
organic_searchalldefaultorganic_search endDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
includeDateboolean- Break results out by date in addition to page. Defaults to false.default
false limitinteger- Maximum number of page rows to return. Defaults to 100.default
100 offsetinteger- Number of rows to skip, for pagination. Defaults to 0.default
0 startDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
openseomcp_get_google_analytics_site_searchRead measured internal search terms with search events, users, sessions, engaged sessions, and engagement rate.Read-onlyGet Google Analytics site search
Read measured internal search terms with search events, users, sessions, engaged sessions, and engagement rate. Requires GA4 site-search measurement. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
endDatestring- Inclusive end date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with startDate. Example: 2026-08-31.
limitinteger- Maximum number of rows to return, between 1 and 1000. Defaults to 100.default
100 offsetinteger- Number of rows to skip before the first row returned, for paging through results beyond limit. Defaults to 0.default
0 startDatestring- Inclusive start date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with endDate; when both are omitted OpenSEO falls back to its standard recent date range. Example: 2026-08-01.
openseomcp_get_google_analytics_traffic_acquisitionCompare session acquisition by channel group, source/medium, or campaign, including sessions, users, engagement, key events, transactions, and revenue.Read-onlyGet Google Analytics traffic acquisition
Compare session acquisition by channel group, source/medium, or campaign, including sessions, users, engagement, key events, transactions, and revenue. Previous-period comparison is available for channel group; source/medium also reports attribution-quality diagnostics. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
breakdownstring- How to group traffic-acquisition sessions: channel_group (default marketing channel groups), source_medium (raw source/medium pairs, plus attribution-quality diagnostics), or campaign (campaign names). Defaults to channel_group.one of
channel_groupsource_mediumcampaigndefaultchannel_group comparePreviousPeriodboolean- When true, adds previous-period comparison values alongside the current period's metrics. Only available when Breakdown is channel_group Defaults to false.default
false endDatestring- Inclusive end date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with startDate. Example: 2026-08-31.
limitinteger- Maximum number of rows to return, between 1 and 1000. Defaults to 100.default
100 offsetinteger- Number of rows to skip before the first row returned, for paging through results beyond limit. Defaults to 0.default
0 startDatestring- Inclusive start date of the reporting window, formatted as YYYY-MM-DD. Must be provided together with endDate; when both are omitted OpenSEO falls back to its standard recent date range. Example: 2026-08-01.
openseomcp_get_project_contextReads a project's shared memory: business overview, current goal, positioning, writing preferences, custom sections, competitors, key pages, and the recent research log.Read-onlyGet Project Context
Reads a project's shared memory: business overview, current goal, positioning, writing preferences, custom sections, competitors, key pages, and the recent research log. Uses no credits. Call this before SEO work to ground it in what the user already told OpenSEO, and check the research log before re-buying research. Sections listed as missing are the ones worth filling with update_project_context.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
openseomcp_get_rank_trackerRead-only access to rank tracker configs and their latest results.Read-onlyGet Rank Tracker
Read-only access to rank tracker configs and their latest results. With `trackerId`, returns config + latest snapshot per keyword, including `trackingKeywordId` for removals. Without it, lists all trackers in the project. Uses no credits. Use create_rank_tracker when no tracker exists; then use add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, or run_rank_tracker to manage it. `lastCheckedAt` shows position freshness.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
trackerIdstring- Rank tracker config ID. If omitted, lists all rank trackers in the project.
openseomcp_get_search_console_performanceQuery the connected Search Console property's Search Analytics: clicks, impressions, CTR, and average position by query/page/country/device/date.Read-onlyGet Google Search Console performance
Query the connected Search Console property's Search Analytics: clicks, impressions, CTR, and average position by query/page/country/device/date. First-party data — use it for what already ranks, near-ranking queries, and pages with real demand. ctr is a 0-1 fraction; position is a 1-based average and is omitted from rows when type is 'discover' or 'googleNews' (Google does not report it there — treat it as unavailable, not a failure); dates are Pacific Time; the last ~3 days may be incomplete. Read-only; uses no credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
dataStatestring- 'all' (default) includes fresh/incomplete recent data.one of
allfinaldefaultall dateRangestring- Convenience window (default last_28_days). End is set ~3 days back for GSC data lag. Ignored if startDate+endDate are given. Max lookback is 16 months.one of
last_7_dayslast_28_dayslast_3_monthslast_6_monthslast_12_monthslast_16_monthsdefaultlast_28_days dimensionsarray- Group rows by these dimensions. Default ['query']. Use ['page'] for top pages, ['query','page'] to map queries to pages / spot cannibalization, ['date'] for a time series.
endDatestring- Explicit end (YYYY-MM-DD, Pacific Time). Use with startDate.
filtersarray- AND-combined filters. To get the queries for one page: [{dimension:'page',operator:'equals',expression:'https://example.com/post'}] with dimensions ['query'].
rowLimitinteger- Rows per call (default 1000, max 1000). GSC sorts by clicks desc and can't filter by position — filter 'striking distance' positions client-side, and paginate with startRow when hasMore is true.default
1000 startDatestring- Explicit start (YYYY-MM-DD, Pacific Time). Use with endDate.
startRowinteger- Pagination offset.default
0 typestring- Search type (default web).one of
webimagevideonewsgoogleNewsdiscoverdefaultweb
openseomcp_get_search_opportunitiesJoin Search Console pages ranking in positions 4–20 with GA4 organic landing-page outcomes, then score matched opportunities by demand, business value, and reachability.Read-onlyGet search opportunities
Join Search Console pages ranking in positions 4–20 with GA4 organic landing-page outcomes, then score matched opportunities by demand, business value, and reachability. Unmatched pages remain visible and unscored. Read-only and uses no OpenSEO credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
endDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
limitinteger- Maximum number of opportunity rows to return. Defaults to 50.default
50 startDatestring- Inclusive YYYY-MM-DD date. Provide both startDate and endDate.
openseomcp_inspect_urlsRun Google Search Console's URL Inspection on up to 10 URLs of the connected property: index/coverage state, last crawl time, Google-selected vs declared canonical, and mobile/rich-results verdicts.Read-onlyInspect URLs in Google Search Console
Run Google Search Console's URL Inspection on up to 10 URLs of the connected property: index/coverage state, last crawl time, Google-selected vs declared canonical, and mobile/rich-results verdicts. Use it to answer 'is this page indexed? why not?'. Per-URL failures are reported inline. Read-only; uses no credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
urlsarrayrequired- 1–10 absolute URLs to inspect. Each must belong to the connected property.
languageCodestring- BCP-47 language for the inspection result (e.g. 'en-US').
openseomcp_list_business_categoriesLists the Google Business categories DataForSEO recognizes, ranked by how many businesses use them.Read-onlyList business categories
Lists the Google Business categories DataForSEO recognizes, ranked by how many businesses use them. Use it to find valid category slugs for search_local_businesses (e.g. 'pizza_restaurant'). Uses no credits (the full list is cached for 7 days).
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
limitinteger- Maximum categories to return (1-200). Defaults to 50.default
50 querystring- Case-insensitive substring to match against category slugs (e.g. 'plumb').
openseomcp_list_projectsLists the user's projects.Read-onlyList Projects
Lists the user's projects. Uses no credits — does not call DataForSEO. Use this whenever you need a `projectId` for another OpenSEO tool. Returns an array of {id, name, domain, locationCode, languageCode}; pass the `id` value as `projectId`. locationCode/languageCode are the project's default market — tools fall back to them when a call omits location/language args. When the user belongs to several organizations, each project is labeled with its organization and organizationId (pass that to create_project).
Inputs
This tool takes no inputs.
openseomcp_list_saved_keywordsLists keywords saved to a project (with cached metrics like search volume, difficulty, CPC, and tags if available).Read-onlyList Saved Keywords
Lists keywords saved to a project (with cached metrics like search volume, difficulty, CPC, and tags if available). Uses no credits — reads from OpenSEO's database, no DataForSEO call. Use tag filters when the user asks for a saved segment; multiple tags match ANY tag.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
limitinteger- Maximum number of saved keyword rows to return: 50, 100, or 250. Defaults to 100.one of
50100250default100 searchstring- Optional keyword text filter; matches keywords containing this text.
tagsarray- Optional tag-name filters (up to 20). A saved keyword matches if it has ANY of the listed tags.
openseomcp_whoamiConfirms the connected OpenSEO account, server mode, token scopes, and current credit balance when the user asks to check their account or connection.Read-onlyWho am I
Confirms the connected OpenSEO account, server mode, token scopes, and current credit balance when the user asks to check their account or connection. Uses no credits — does not call DataForSEO.
Inputs
This tool takes no inputs.
openseomcp_add_rank_tracking_keywordsAdd keywords to an existing rank tracker.WriteAdd Rank Tracking Keywords
Add keywords to an existing rank tracker. The mutation itself uses no credits and does not start a check or fetch metrics, but scheduled trackers will spend credits on future recurring checks. For a scheduled tracker, call estimate_rank_tracker_cost with additionalKeywordCount, show the recurring estimate and live-fallback caveat to the user, and pass the approved nominal per-check estimate as maxEstimatedScheduledCheckCredits. This approval is not a runtime spending cap: rejected, failed, or timed-out queued tasks may use additional separately billed live fallback. Existing and repeated keywords are skipped, and `added` is the number actually inserted.
Inputs
keywordsarrayrequired- Keywords to track. Existing and repeated keywords are skipped.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
trackerIdstringrequired- Rank tracker ID from get_rank_tracker.
matchCaseboolean- Track the keywords exactly as typed instead of lowercasing them. Defaults to false. Use for brand names where Google's results differ by capitalization; a cased keyword is tracked and billed separately from its lowercase form.default
false maxEstimatedScheduledCheckCreditsinteger- Nominal queued credits per scheduled check that the user approved after seeing estimate_rank_tracker_cost with additionalKeywordCount. Required for scheduled trackers. This is an estimate approval, not a runtime cap; live fallback may add separately billed credits.
openseomcp_create_projectCreate a new project in the user's organization.WriteCreate Project
Create a new project in the user's organization. Uses no credits — does not call DataForSEO. Provide a name, and optionally a domain and default market (locationCode/languageCode; a languageCode requires a locationCode). Returns the created {id, name, domain, locationCode, languageCode, url}; pass the returned `id` as `projectId` to other OpenSEO tools. Call list_projects first to avoid creating a duplicate.
Inputs
namestringrequired- Project name, 1-120 characters. This becomes the project's display name in OpenSEO.
domainstring- Optional root domain for the project, host only (no scheme or path), e.g. 'example.com'. Sets the default target for domain, backlink, and rank tools.
languageCodestring- Optional language code for the project's default market, e.g. 'en' or 'fr'. Requires locationCode to be set; derived from the location when omitted.
locationCodeinteger- Optional DataForSEO location code for the project's default market, e.g. 2840 for United States or 2504 for Morocco. Falls back to the organization default when omitted.
organizationIdstring- Organization id to create the project in. Required when the user belongs to more than one organization; omitting it in that case returns the list of organizations instead of creating a project, so confirm the choice with the user before retrying.
openseomcp_create_rank_trackerCreate a rank tracking configuration for a project.WriteCreate Rank Tracker
Create a rank tracking configuration for a project. Creating an empty tracker uses no credits and starts no check, but daily, weekly, and monthly trackers will spend credits after keywords are added. The domain defaults to the project's domain; market defaults to the project's market; devices default to mobile, search depth to 40, and schedule to manual. Use estimate_rank_tracker_cost before adding keywords to a scheduled tracker or starting a live run. Call get_rank_tracker first to avoid duplicates.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
devicesstring- Devices to track. Defaults to mobile.one of
desktopmobilebothdefaultmobile domainstring- Domain to track. Defaults to the project's domain. Accepts a hostname or URL and stores the normalized hostname.
languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
locationCodeinteger- DataForSEO location code. Defaults to the project's default market (see list_projects; editable in project settings). See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
locationNamestring- Optional city or region name for local rank tracking.
scheduleIntervalstring- Check schedule. Defaults to manual so creating a tracker cannot cause future credit spend. Scheduled checks may use credits later.one of
manualdailyweeklymonthlydefaultmanual serpDepthinteger- Number of Google results to inspect. Defaults to 40.default
40
openseomcp_find_serp_competitorsCompares domains competing in Google results for a supplied keyword set in a country-level DataForSEO Labs market.WriteFind SERP competitors
Compares domains competing in Google results for a supplied keyword set in a country-level DataForSEO Labs market. Accepts location/language codes; not radius-based local SEO. Charges credits.
Inputs
keywordsarrayrequired- Keywords whose SERPs are compared (1-100).
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
excludeDomainsarray- Domains to exclude from results (e.g. the user's own site).
includeSubdomainsboolean- Count subdomains as part of the same competitor domain.
languageCodestring- Language for locationCode. Defaults to that location's primary language when locationCode overrides the project market.
limitinteger- Maximum competitors to return (1-100). Defaults to 50.default
50 locationCodeinteger- Country-level DataForSEO Labs location code. Defaults to the project's market; takes precedence over the legacy market object.
marketobject- Legacy US selector. Prefer locationCode/languageCode for any Labs market. Explicit locationCode takes precedence; otherwise omitted = the project's default market.
offsetinteger- Rows to skip for pagination.default
0 resultTypesarray- SERP result types to include. Defaults to organic and local_pack.
sortBystring- Sort order for returned competitors. Defaults to visibility.one of
visibilitytraffic_estimateavg_positionkeyword_countdefaultvisibility
openseomcp_get_audit_statusCheck the progress of a site audit (phase, pages crawled, Lighthouse progress).WriteGet site audit status
Check the progress of a site audit (phase, pages crawled, Lighthouse progress). Free — reads OpenSEO state and may reconcile a dead workflow by marking its audit failed. Omit auditId for the most recent audit.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
auditIdstring- ID of the audit to check. If omitted, uses the project's most recent audit. Example: audit_5f3a1b2c.
openseomcp_get_backlinks_overviewReturns a backlinks profile summary (total backlinks, referring domains, top referring domains).WriteGet Backlinks Overview
Returns a backlinks profile summary (total backlinks, referring domains, top referring domains). Charges credits (~50 typical for a domain, ~25 for a single page). Note: bare domains default to scope 'subdomains'; pass scope 'domain' to exclude subdomains from the totals. Targets with a path default to 'subfolder', whose counts come from filtered backlink totals (no rank/trends/referring-domain breakdown). Trend data always includes subdomains (provider limitation). Self-hosted deployments need the Backlinks API enabled on their DataForSEO account.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
targetstringrequired- Domain or URL to analyze (e.g. 'example.com' or 'https://example.com/blog').
hideSpamboolean- Filter out spammy referring domains. Defaults to true.default
true scopestring- Research scope: 'domain' (hostname without subdomains), 'subdomains' (hostname plus all subdomains), 'subfolder' (path and its children), or 'exact_url' (one page). Defaults to 'subdomains' for root inputs and 'subfolder' when the input has a path. 'page' is a deprecated alias of 'exact_url'. Subfolder counts are computed from filtered backlink totals; rank, trends, and the referring-domains breakdown are unavailable for subfolders.one of
exact_urlsubfolderdomainsubdomainspage
openseomcp_get_backlinks_profileReturns one bounded page of detailed backlink rows for a domain or page: linking URLs, target URLs, anchors, dofollow/nofollow, authority/spam signals, and lost/broken status.WriteGet Backlinks Profile
Returns one bounded page of detailed backlink rows for a domain or page: linking URLs, target URLs, anchors, dofollow/nofollow, authority/spam signals, and lost/broken status. Supports filters, sorting, one_per_domain/as_is mode, and pagination. Charges credits (~30 per page typical). Self-hosted deployments need the Backlinks API enabled on their DataForSEO account.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
targetstringrequired- Domain or URL to analyze (e.g. 'example.com' or 'https://example.com/blog').
filtersobject- Backlink row filters: include/exclude source URL terms, authority/spam ranges, dofollow/nofollow, lost/broken visibility, or exact domainFrom.
hideSpamboolean- Filter out spammy backlinks. Defaults to true.default
true modestring- DataForSEO backlink grouping: one_per_domain returns each referring domain's strongest link; as_is returns individual backlink rows.one of
one_per_domainas_isdefaultone_per_domain pageinteger- 1-indexed results page. Defaults to 1.default
1 pageSizeinteger- Rows per page. Allowed values: 50, 100, or 200.one of
50100200default100 scopestring- Research scope: 'domain' (hostname without subdomains), 'subdomains' (hostname plus all subdomains), 'subfolder' (path and its children), or 'exact_url' (one page). Defaults to 'subdomains' for root inputs and 'subfolder' when the input has a path. 'page' is a deprecated alias of 'exact_url'. Subfolder counts are computed from filtered backlink totals; rank, trends, and the referring-domains breakdown are unavailable for subfolders.one of
exact_urlsubfolderdomainsubdomainspage sortFieldstring- Backlink row sort field.one of
rankdomainRankspamScorefirstSeendefaultfirstSeen sortOrderstring- Sort direction.one of
ascdescdefaultdesc
openseomcp_get_business_profileReads one Google Business Profile: categories, rating and review count, rating breakdown, address, phone, website, claimed status, opening hours, and photo count.WriteGet business profile
Reads one Google Business Profile: categories, rating and review count, rating breakdown, address, phone, website, claimed status, opening hours, and photo count. Use it to audit your own profile or to compare a competitor's. Charges credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
businessNamestring- Business name as it appears on Google. Supply exactly one of businessName, cid, or placeId.
cidstring- Google-defined business CID (from get_local_serp_results rows). Most precise identifier.
languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
locationCodeinteger- DataForSEO location code. Ignored when `near` is set; otherwise defaults to the project's market.
nearobject- Coordinate to search from. Use it when the business name is ambiguous; otherwise locationCode is enough.
placeIdstring- Google Maps place_id (from get_local_serp_results rows).
openseomcp_get_business_reviewsCollects Google reviews for a business, with rating, author, text, and whether the owner replied.WriteGet business reviews
Collects Google reviews for a business, with rating, author, text, and whether the owner replied. Use it for review-gap analysis against competitors and to spot unanswered reviews. Usually completes within this call; if the queued job is still running you get status 'processing' plus a taskId — call again with that taskId in 30-60 seconds to collect the result at no extra cost. Charges credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
businessNamestring- Business name as it appears on Google. Supply exactly one of businessName, cid, or placeId.
cidstring- Google-defined business CID (from get_local_serp_results rows). Most precise identifier.
depthinteger- Number of reviews to collect (10-200). Defaults to 20. Billed per 10 reviews (per 20 when includeOtherSources is true).default
20 includeOtherSourcesboolean- Also collect the reviews Google shows from other sites (Yelp, Tripadvisor, Trustpilot). Defaults to false. Costs more per review and cannot be sorted.default
false languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
locationCodeinteger- DataForSEO location code. Ignored when `near` is set; otherwise defaults to the project's market.
nearobject- Coordinate to search from. Use it when the business name is ambiguous; otherwise locationCode is enough.
placeIdstring- Google Maps place_id (from get_local_serp_results rows).
sortBystring- Review sort order. Defaults to newest. Ignored when includeOtherSources is true — the extended endpoint has no sort option.one of
newesthighest_ratinglowest_ratingrelevantdefaultnewest taskIdstring- Resume a previous call that returned status "processing". Pass back the taskId exactly as returned (format "google:<id>" or "extended:<id>"); it selects the right endpoint on its own. Resuming charges no extra credits.
openseomcp_get_business_updatesCollects the posts (updates, offers, events) published on a Google Business Profile.WriteGet business updates
Collects the posts (updates, offers, events) published on a Google Business Profile. Use it to check posting activity and recency on your profile or a competitor's. Usually completes within this call; a 'processing' response returns a taskId to call back with in 30-60 seconds at no extra cost. Charges credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
businessNamestring- Business name as it appears on Google. Supply exactly one of businessName, cid, or placeId.
cidstring- Google-defined business CID (from get_local_serp_results rows). Most precise identifier.
depthinteger- Number of posts to collect (10-100). Defaults to 10.default
10 languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
locationCodeinteger- DataForSEO location code. Ignored when `near` is set; otherwise defaults to the project's market.
nearobject- Coordinate to search from. Use it when the business name is ambiguous; otherwise locationCode is enough.
placeIdstring- Google Maps place_id (from get_local_serp_results rows).
taskIdstring- Resume a previous call that returned status "processing". Pass back the taskId exactly as returned. Resuming charges no extra credits.
openseomcp_get_domain_keyword_suggestionsReturns the organic keywords a domain ranks for, including position and available metrics.WriteGet Domain Keyword Opportunities
Returns the organic keywords a domain ranks for, including position and available metrics. Use after get_domain_overview when you want the detailed keyword opportunity list for a competitor or reference domain. Charges credits (~100-300 typical). Cached for 12 hours.
Inputs
domainstringrequired- Competitor or reference domain or URL to extract ranked keywords from.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
languageCodestring- Language code, e.g. 'en', 'es', 'vi'. Defaults to the project's default market language.
locationCodeinteger- DataForSEO location code, e.g. 2840 for United States or 2504 for Morocco. Defaults to the project's default market. Some countries (e.g. Iceland, 2352) are served from Google Ads data, where keyword difficulty, search intent, and domain analytics are unavailable.
scopestring- Research scope: 'domain' (hostname without subdomains), 'subdomains' (hostname plus all subdomains), 'subfolder' (path and its children), or 'exact_url' (one page). Defaults to 'subdomains' for root inputs and 'subfolder' when the input has a path.one of
exact_urlsubfolderdomainsubdomains
openseomcp_get_domain_overviewReturns a high-level view of a domain's organic footprint: estimated organic traffic, organic keyword count, backlinks, and referring domains.WriteGet Domain Overview
Returns a high-level view of a domain's organic footprint: estimated organic traffic, organic keyword count, backlinks, and referring domains. Use this first for domain research; for the detailed ranked-keyword list, call get_domain_keyword_suggestions next. Charges credits (~100-300 typical). Cached for 12 hours per domain.
Inputs
domainstringrequired- Domain or URL to analyze, e.g. 'example.com'.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
includeSubdomainsboolean- Deprecated: use scope ('subdomains' or 'domain') instead.
languageCodestring- Language code, e.g. 'en', 'es', 'vi'. Defaults to the project's default market language.
locationCodeinteger- DataForSEO location code, e.g. 2840 for United States or 2504 for Morocco. Defaults to the project's default market. Some countries (e.g. Iceland, 2352) are served from Google Ads data, where keyword difficulty, search intent, and domain analytics are unavailable.
scopestring- Research scope: 'domain' (hostname without subdomains), 'subdomains' (hostname plus all subdomains), 'subfolder' (path and its children), or 'exact_url' (one page). Defaults to 'subdomains' for root inputs and 'subfolder' when the input has a path. Overview metrics always cover the hostname plus subdomains; narrower scopes are labeled accordingly — use get_ranked_keywords with a scope for scoped keyword data.one of
exact_urlsubfolderdomainsubdomains
openseomcp_get_google_business_questionsFetches Google Business Profile questions and answers for one business (by businessName, cid, or placeId) near a coordinate.WriteGet Google business questions
Fetches Google Business Profile questions and answers for one business (by businessName, cid, or placeId) near a coordinate. Run this only when Q&A evidence is needed. Charges credits.
Inputs
nearobjectrequired- Coordinate and radius to search around.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
businessNamestring- Business name as it appears on Google. Supply exactly one of businessName, cid, or placeId.
cidstring- Google-defined business CID (from get_local_serp_results rows). Most precise identifier.
depthinteger- Maximum Q&A rows to fetch (1-100). Defaults to 20.default
20 languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
placeIdstring- Google Maps place_id (from get_local_serp_results rows).
openseomcp_get_keyword_metricsHydrate up to 700 known keywords with search volume, keyword difficulty (KD), search intent, CPC, competition, and monthly trends in a single call.WriteGet keyword metrics
Hydrate up to 700 known keywords with search volume, keyword difficulty (KD), search intent, CPC, competition, and monthly trends in a single call. Use it to score candidate or known keywords — including Search Console striking-distance queries — by real demand and ranking difficulty. For countries served from Google Ads data (e.g. Iceland), KD and intent are null. Charges credits.
Inputs
keywordsarrayrequired- Keywords to fetch metrics for (1-700).
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
includeClickstreamDataboolean- Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). DOUBLES the credit cost of the call. Default false. No effect for countries served from Google Ads data.default
false includeMonthlyTrendsboolean- Include monthly search-volume trend rows. Defaults to true.default
true languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
locationCodeinteger- DataForSEO location code. Defaults to the project's default market (see list_projects; editable in project settings). See dataforseo.com/help-center/locations. Some countries (e.g. Iceland, 2352) are served from Google Ads data: keyword volume/CPC/trends work, but keyword difficulty, search intent, and domain analytics are unavailable.
sortBystring- Sort order for returned rows. Defaults to search_volume.one of
search_volumekeyword_difficultycpccompetitiondefaultsearch_volume
openseomcp_get_local_rank_gridRuns one Google Maps search per point of a square grid around a coordinate and reports where the target business ranks at each point — plus each point's result count and #1 business — revealing how far its Maps visibility reaches.WriteGet local rank grid
Runs one Google Maps search per point of a square grid around a coordinate and reports where the target business ranks at each point — plus each point's result count and #1 business — revealing how far its Maps visibility reaches. Cost scales with the grid: gridSize squared SERP calls (3x3 = 9, the sensible default; 5x5 = 25). Charges credits per grid point.
Inputs
centerobjectrequired- Coordinate the grid is centered on (usually the storefront).
keywordstringrequired- Search query to run on Google Maps at every grid point.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
targetobjectrequired- The business to locate in each result set. Supply at least one of cid, placeId, or name.
devicestring- Device the SERP is rendered for. Defaults to mobile.one of
desktopmobiledefaultmobile gridSizeinteger- Grid width: 3 (9 searches) or 5 (25 searches). Defaults to 3.one of
35default3 languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
spacingKmnumber- Distance between neighbouring grid points, in km. Defaults to 2.default
2 zoominteger- Map zoom every point is searched at. Defaults to a zoom derived from spacingKm and latitude so each point's viewport spans the grid spacing; override only when you need a specific viewport.
openseomcp_get_local_serp_resultsFetches one Google Maps or Local Finder SERP near a coordinate.WriteGet local SERP results
Fetches one Google Maps or Local Finder SERP near a coordinate. Returns trimmed provider rows (identity, rank, rating, categories, hours) with rank fields intact; callers decide how to match a target business. Charges credits.
Inputs
keywordstringrequired- Search query to run on Google Maps or Local Finder.
nearobjectrequired- Coordinate (and optional map zoom) the SERP is fetched from.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
depthinteger- Number of results to fetch (1-100). Defaults to 20.default
20 devicestring- Device the SERP is rendered for. Defaults to mobile, matching get_local_rank_grid.one of
desktopmobiledefaultmobile languageCodestring- Language code (e.g. 'en', 'es', 'vi'). Defaults to the project's default market language (see list_projects).
searchTypestring- Which local SERP to fetch. Defaults to maps.one of
mapslocal_finderdefaultmaps
openseomcp_get_ranked_keywordsReturns market-specific keyword, URL, rank, search volume, CPC, intent, and traffic rows for a domain or page.WriteGet ranked keywords
Returns market-specific keyword, URL, rank, search volume, CPC, intent, and traffic rows for a domain or page. Accepts country-level DataForSEO Labs location/language codes. Use this for strategy evidence; use get_domain_overview for aggregate domain footprint. Charges credits.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
targetstringrequired- Domain (no protocol/www) or absolute page URL to list ranked keywords for.
excludeBrandTermsarray- Exclude keywords containing any of these brand terms.
includeSubdomainsboolean- Deprecated: use scope ('subdomains' or 'domain') instead.
languageCodestring- Language for locationCode. Defaults to that location's primary language when locationCode overrides the project market.
limitinteger- Maximum rows to return (1-100). Defaults to 50.default
50 locationCodeinteger- Country-level DataForSEO Labs location code. Defaults to the project's market; takes precedence over the legacy market object.
marketobject- Legacy US selector. Prefer locationCode/languageCode for any Labs market. Explicit locationCode takes precedence; otherwise omitted = the project's default market.
maxRankinteger- Only return keywords ranking at this position or better.
minSearchVolumeinteger- Only return keywords with at least this monthly search volume.
offsetinteger- Rows to skip for pagination.default
0 resultTypesarray- SERP result types to include. Defaults to organic and paid.
scopestring- Research scope: 'domain' (hostname without subdomains), 'subdomains' (hostname plus all subdomains), 'subfolder' (path and its children), or 'exact_url' (one page). Defaults to 'subdomains' for root inputs and 'subfolder' when the input has a path.one of
exact_urlsubfolderdomainsubdomains sortBystring- Sort order for returned rows. Defaults to search_volume.one of
ranksearch_volumetraffic_estimatecpcdefaultsearch_volume
openseomcp_get_serp_resultsFetch live Google organic search results for 1-10 keywords.WriteGet Google SERP Results
Fetch live Google organic search results for 1-10 keywords. Use this to inspect who ranks for a query, verify competitors, compare SERPs across keywords, or gather source URLs before content planning. Returns the top `depth` result rows per keyword (default 20). Charges credits per keyword: ~5 each at the default depth 20, and each additional 10 of depth adds ~2.5. Does not save results to OpenSEO. Per-keyword errors don't fail the batch.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
queriesarrayrequired- 1-10 queries. Bulk-friendly — prefer this over multiple single-query calls.
depthinteger- How many SERP rows to crawl per keyword — a multiple of 10 from 10 to 100, default 20. Google has no offset, so a deeper crawl re-fetches the top too: each additional 10 adds ~2.5 credits per keyword. Only raise it when you need ranks past the top 20.default
20
openseomcp_research_keywordsResearch keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call.WriteResearch Keywords (Bulk)
Research keyword data (search volume, difficulty, CPC, related ideas) for 1-5 seed keywords in one call. Charges credits per seed (~30-100 credits each, varies by source; flat ~96 for countries served from Google Ads data, where difficulty/intent are unavailable). Returns per-seed results — a single bad seed won't fail the batch.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
seedsarrayrequired- 1-5 seed keywords. Each seed is researched independently and returns related keywords with volume/difficulty/CPC. Bulk-friendly — prefer this over multiple single-seed calls.
includeClickstreamDataboolean- Refine search volumes with clickstream data, which disaggregates Google Ads' grouped close-variant volumes (plurals/misspellings). Doubles the credit cost of each seed. Defaults to false (standard Google-Ads-derived volumes). Has no effect for countries served from Google Ads data.default
false resultLimitinteger- Maximum related keywords returned per seed: 150, 300, or 500. Defaults to 150.one of
150300500default150
openseomcp_run_rank_trackerStart an explicit live rank check for every keyword and configured device.WriteRun Rank Tracker
Start an explicit live rank check for every keyword and configured device. This spends credits: call estimate_rank_tracker_cost, show the estimate to the user, and pass the approved credit amount as maxCostCredits. A fresh estimate above that ceiling is rejected. Hosted accounts require a paid plan, while self-hosted deployments are not plan-gated. If a run is already in progress, its blocking run ID is reported without starting or charging another check. The schedule is unchanged.
Inputs
maxCostCreditsintegerrequired- Maximum credits the user approved after seeing estimate_rank_tracker_cost. The run is rejected if its fresh estimate is higher.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
trackerIdstringrequired- Rank tracker ID from get_rank_tracker.
openseomcp_run_site_auditStart a site audit: crawls the site (robots.txt-aware, same-origin), checks every page for SEO issues (broken links, duplicate/missing titles and descriptions, redirect chains, orphan pages, canonical problems, thin content, and more), and optionally runs Lighthouse on a sample of pages.WriteRun site audit
Start a site audit: crawls the site (robots.txt-aware, same-origin), checks every page for SEO issues (broken links, duplicate/missing titles and descriptions, redirect chains, orphan pages, canonical problems, thin content, and more), and optionally runs Lighthouse on a sample of pages. Runs in the background — poll get_audit_status, then read get_audit_issues. If the site rate limits the crawler it slows down and retries; pages it still cannot read are honestly flagged as blocked or rate-limited rather than misreported.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID that scopes this call to a specific connected property. Obtain valid project IDs from the list_projects tool. Example: proj_8f3a1c2b9d4e.
urlstringrequired- The start URL to crawl. The crawl stays same-origin and honors the site's robots.txt. Example: https://www.example.com/.
maxPagesinteger- Page budget for the crawl, between 10 and 10000. Defaults to 50.default
50 runLighthouseboolean- When true, runs Lighthouse on a sample of up to 10 representative pages, adding several minutes of wall-clock time. Pass true only when performance/Core Web Vitals detail is wanted. Defaults to false.default
false
openseomcp_search_local_businessesSearches local business listings near a coordinate, with optional rating, review-count, and claimed-status filters.WriteSearch local businesses
Searches local business listings near a coordinate, with optional rating, review-count, and claimed-status filters. Use this to find local business candidates, nearby competitors, or unclaimed listings; it does not run Maps rank checks or Q&A. Returns a compact row per business (identity, contact, rating, claim status); use get_business_profile for one business's full profile. Charges credits.
Inputs
nearobjectrequired- Coordinate and radius to search around.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
categoriesarray- Business categories to filter by (e.g. 'pizza_restaurant').
isClaimedboolean- Filter by whether the listing is claimed by its owner. false surfaces unclaimed listings (outreach prospects).
limitinteger- Maximum businesses to return (1-50). Defaults to 20.default
20 minRatingnumber- Only return businesses rated at least this (1-5).
minReviewsinteger- Only return businesses with at least this many Google reviews.
offsetinteger- Rows to skip for pagination.default
0 querystring- Business name or title text to match.
sortBystring- Sort order for returned rows. Defaults to relevance.one of
relevanceratingreviewsdefaultrelevance
openseomcp_remove_rank_tracking_keywordsStop tracking keywords by their trackingKeywordId.DestructiveRemove Rank Tracking Keywords
Stop tracking keywords by their trackingKeywordId. Uses no credits and preserves historical snapshots. Missing, stale, foreign, and repeated IDs are ignored; `removed` is the number actually deleted from this tracker.
Inputs
keywordIdsarrayrequired- Tracking keyword IDs to remove. Use `trackingKeywordId` values returned by get_rank_tracker.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
trackerIdstringrequired- Rank tracker ID from get_rank_tracker.
openseomcp_save_keywordsSave keywords to a project's saved-keywords list.DestructiveSave Keywords
Save keywords to a project's saved-keywords list. Uses no credits — does not call DataForSEO. Idempotent: re-saving an existing keyword is a no-op. If tags are provided, missing tags may be created. By default tags are appended; set tagMode=replace to remove existing tags from these saved keywords before applying the provided tags, which is useful for reorganizing keywords into page/topic clusters. Ask the user for confirmation before applying or replacing tags broadly.
Inputs
keywordsarrayrequired- Keywords to save, 1-100. Saving an already-saved keyword is a no-op.
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
languageCodestring- Language code, e.g. 'en', 'es', 'vi'. Defaults to the project's default market language.
locationCodeinteger- DataForSEO location code, e.g. 2840 for United States or 2504 for Morocco. Defaults to the project's default market. Some countries (e.g. Iceland, 2352) are served from Google Ads data, where keyword difficulty, search intent, and domain analytics are unavailable.
metricsarray- Optional cached metrics for the saved keywords, one entry per keyword matched by its keyword field. Copy searchVolume, keywordDifficulty, cpc, competition and intent straight from the matching research_keywords rows, and map each row's trend to monthlySearches.
tagModestring- How to apply tags: 'append' adds the given tags to any existing ones (default); 'replace' removes existing tags from these saved keywords before applying the given tags — useful for reorganizing keywords into page/topic clusters.one of
appendreplacedefaultappend tagsarray- Optional tags to attach to every saved keyword in this call. Missing tag names may be created. Ask the user for explicit confirmation before using this, especially when saving many keywords or creating new tag names.
openseomcp_update_project_contextWrites to a project's shared memory so the app, SAM, and other agents see it.DestructiveUpdate Project Context
Writes to a project's shared memory so the app, SAM, and other agents see it. Uses no credits. Send a list of patch ops; sections are prose (~4,000 chars max), competitors and key pages are curated shortlists (100 max each), and appendResearchLog records what research was bought so nobody re-buys it. Confirm facts with the user before storing them.
Inputs
projectIdstringrequired- Required. The OpenSEO project ID to scope this call to. Get one from list_projects.
updatesarrayrequired- Patch ops, applied in order. Empty section content clears the section; adds upsert by domain/url; research-log entries are date-stamped by the server.
No tools match.
