SEO Console
NPM · SEO-CONSOLE-MCP · SCANNED SEP 25
Search Console, Google Ads, App Store, Google Play, WordPress.org and Core Web Vitals over MCP
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- Known CVEs were checked across the 177 of 178 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
- No install/post-install scripts declared.Pass
- Dependency health was assessed across the 177 of 178 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 0 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability83
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 6420 tokens (~145/item across 44 items; 43 tools + 1 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "delete_sitemap" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 44 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
How do I install the SEO Console MCP server?
SEO Console runs locally as an npm package, launched with npx -y seo-console-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · seo-console-mcp
claude mcp add ibrahimhajjaj-seo-console-mcp -- npx -y seo-console-mcp
{
"mcpServers": {
"ibrahimhajjaj-seo-console-mcp": {
"command": "npx",
"args": [
"-y",
"seo-console-mcp"
]
}
}
} {
"servers": {
"ibrahimhajjaj-seo-console-mcp": {
"command": "npx",
"args": [
"-y",
"seo-console-mcp"
]
}
}
} codex mcp add ibrahimhajjaj-seo-console-mcp -- npx -y seo-console-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ibrahimhajjaj-seo-console-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"seo-console-mcp"
],
"enabled": true
}
}
} openclaw mcp add ibrahimhajjaj-seo-console-mcp --command npx --arg -y --arg seo-console-mcp
mcp_servers:
ibrahimhajjaj-seo-console-mcp:
command: "npx"
args: ["-y", "seo-console-mcp"] {
"McpServers": {
"ibrahimhajjaj-seo-console-mcp": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"seo-console-mcp"
]
}
}
} assistant mcp add ibrahimhajjaj-seo-console-mcp -t stdio -c npx -a -y seo-console-mcp
{
"mcpServers": {
"ibrahimhajjaj-seo-console-mcp": {
"command": "npx",
"args": [
"-y",
"seo-console-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 25 Sept 26 70
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 25 Sept 2026 · Analysed npm/seo-console-mcp@0.18.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 177 packages
| Packages resolved | 177 |
|---|---|
| Deprecated | 3 |
| Stale | 46 |
| Tree resolution | Partial |
The dependency tree was only partially resolved, so these counts may be incomplete.
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ads_ad_copy ~202
Read what a Google Ads ad actually says: every headline and description with its pinning and Google's performance label, the display path, the final URLs, and the policy topics behind a limited or disapproved status rather than only the status word. Also reports headline text shared by more than one ad, since two ads in an ad group with the same headlines are not testing anything against each other. Assets such as sitelinks and promotions are not read here; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| adGroup | string | – | Limit to one ad group by name. Omitted, every ad in the account is read, which is what answers whether a headline is repeated across ad groups |
| adId | string | – | Limit to one ad by its numeric id, for reading back the copy that was supposed to ship |
| includeRemoved | boolean | – | Include removed ads. Off by default: a removed ad's copy is history, and it crowds out the ads that are serving |
| Name | Type | Req | Description |
|---|---|---|---|
| ads | array | yes | – |
| duplicateHeadlines | array | yes | Headline text appearing in more than one ad, with the ads carrying it. Two ads in one ad group sharing headlines test nothing against each other |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_ads ~44
Read Google Ads ads with ad strength, policy approval status, serving status and metrics; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | How many days back to report, ending today |
| Name | Type | Req | Description |
|---|---|---|---|
| ads | array | yes | – |
| days | number | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_assets ~216
Read the sitelinks, callouts, structured snippets, promotions, prices, call and image assets attached to the account, its campaigns and its ad groups, with what each one actually says rather than only its type and id. An account-level asset applies to every campaign, so it is listed even when one campaign is named: an ad that looks bare in ads_ad_copy may be serving with these beside it. Attached is not shown, and a level that cannot be read is reported as an error in place rather than as nothing attached; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| campaign | string | – | Limit campaign and ad group assets to one campaign by name. Account-level assets are still listed, because they apply to every campaign including this one |
| includeRemoved | boolean | – | Include links whose status is removed. Off by default: a removed asset is history and crowds out the ones that can serve |
| type | string | – | Limit to one asset type. Omitted, every type is listed, including types this tool has no shaped reading for |
| Name | Type | Req | Description |
|---|---|---|---|
| assets | array | yes | – |
| byType | object | yes | How many of each type were found, so an absent type is visible as absent |
| levelErrors | array | yes | A level that could not be read is recorded here rather than omitted, so an empty list is never mistaken for nothing attached |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_campaigns ~66
Read Google Ads campaigns: status, daily budget, impressions, clicks, cost and conversions over a window. Needs GOOGLE_ADS_DEVELOPER_TOKEN, an OAuth client and a refresh token; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | How many days back to report, ending today |
| Name | Type | Req | Description |
|---|---|---|---|
| campaigns | array | yes | – |
| days | number | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_changes ~148
Read the Google Ads change history: what changed, when, which fields, by whom, and whether it came from a tool or from someone in the browser. Google keeps 30 days and at most 10,000 rows, so an empty result over a longer window is a limit rather than a finding. Filter on resourceType rather than on changed field names: a budget change reports amountMicros and says neither budget nor status. This is the audit trail for anything ads_update writes; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | How many days of change history to read, ending now. Google keeps 30 days and refuses more |
| limit | integer | – | Most recent changes to return |
| Name | Type | Req | Description |
|---|---|---|---|
| changes | array | yes | – |
| days | number | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_keyword_create ~339
Add one keyword to an ad group. This is the only tool here that creates rather than changes, and it is guarded differently for that reason: there is no current value to compare against, so it is a duplicate check instead. It refuses a keyword that already exists in the target ad group, including a removed one, since a removed criterion still holds the text and Google rejects the create with an error naming a resource the interface does not show. A copy elsewhere in the account trips a guard rather than refusing, because two copies compete for the same budget. EXACT by default; PHRASE and BROAD buy more than the text written and each trips a guard. Dry run unless dryRun is false, and the keyword is read back afterwards
| Name | Type | Req | Description |
|---|---|---|---|
| adGroup | string | yes | The ad group to add it to. It must match exactly one or nothing is added |
| bid | number | yes | The max CPC bid in dollars. There is no current bid to compare against on a create, so the only size check is the ceiling |
| confirm | boolean | – | Add it even though a guard tripped. The dry run lists every reason, so this confirms something already read |
| dryRun | boolean | – | Report what would be added and which guards it trips, without adding anything |
| keyword | string | yes | The keyword text to add. It is created as written; this tool does not guess at variants |
| matchType | string | – | How the keyword matches. EXACT by default because it is the one that buys what it says; PHRASE and BROAD buy more than the text written here and each trips a guard |
| Name | Type | Req | Description |
|---|---|---|---|
| adGroup | string | yes | – |
| applied | boolean | yes | – |
| bid | number | yes | – |
| campaign | string | yes | – |
| customerId | string | yes | – |
| guards | array | yes | A create is guarded by a duplicate check rather than a before-and-after comparison, because there is no before |
| keyword | string | yes | – |
| matchType | string | yes | – |
| matches | – | yes | – |
| notes | array | yes | – |
| readBack | – | yes | The keyword as the account holds it after the write. Null when it could not be read back, which is not the same as not created |
No examples provided.
ads_keywords ~112
Read every Google Ads keyword with its effective CPC bid, approval and serving status, and metrics. Returns every row rather than a first page, which is how a count taken from the console goes wrong; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | How many days back to report, ending today |
| status | string | – | Limit to one keyword state. Omitted, every keyword is returned with its state named, because dropping rows silently is how a count taken from this tool goes wrong the way a console count does |
| Name | Type | Req | Description |
|---|---|---|---|
| days | number | yes | – |
| keywords | array | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_negatives ~103
Read the negative keywords already in place, at campaign, ad group or shared-set level. A negative blocks traffic without leaving any record that it did, so this is what to check when a keyword stops serving and nothing looks wrong, and what to check before adding a term twice; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| level | string | – | Which negatives to read. A term blocked at campaign level is blocked everywhere in it; a shared set applies to every campaign it is attached to |
| Name | Type | Req | Description |
|---|---|---|---|
| negatives | array | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
No examples provided.
ads_negatives_update ~289
Add or remove negative keywords in a batch, enumerated one by one with no pattern form. Before adding, every proposed negative is checked against the campaign's own live keywords and the batch is refused if one would block traffic, because a wrong negative leaves no evidence anywhere: the traffic just stops. Dry run unless dryRun is false, and the terms are read back afterwards
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | Add negative keywords or remove existing ones. Removal matters as much as adding: a wrong negative shows up as nothing at all |
| confirm | boolean | – | Perform the batch even though a guard tripped. The dry run lists what tripped, so this confirms something already read |
| dryRun | boolean | – | Report what would change, and which proposed negatives would block a live keyword, without changing anything |
| keywords | array | yes | The negative terms, enumerated one by one. There is no pattern or match-all form: a selector is one typo away from blocking a whole campaign |
| level | string | – | Where the negatives live. A campaign-level negative blocks the term everywhere in that campaign |
| matchType | string | – | How each term blocks. BROAD blocks any query containing all its words, which is the setting that can silently kill a campaign |
| target | string | yes | The campaign or ad group name. It must match exactly one or nothing is changed |
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | – |
| applied | boolean | yes | – |
| changed | array | yes | – |
| collisions | array | yes | Proposed negatives that would stop one of this campaign's own live keywords from serving. This is the error that otherwise produces no evidence at all |
| guards | array | yes | – |
| level | string | yes | – |
| matchType | string | yes | – |
| notes | array | yes | – |
| requested | array | yes | – |
| skipped | array | yes | Terms not sent, because they are already present when adding or absent when removing |
| target | string | yes | – |
No examples provided.
ads_query ~72
Run an arbitrary GAQL SELECT against the Google Ads account for a question the shaped reads do not cover. GAQL has no statement other than SELECT, so this cannot change anything; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | A GAQL SELECT statement. GAQL has no other statement, so this cannot change anything |
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | – |
| rowCount | number | yes | – |
| rows | array | yes | – |
No examples provided.
ads_search_terms ~137
Read the queries that actually triggered an ad, with the keyword each one matched and its metrics. This is the paid equivalent of the Search Console query dimension. Google withholds terms too few people searched, so an absent term is unknown rather than absent; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | How many days back to report, ending today |
| minCost | number | – | Drop search terms that cost less than this over the window |
| minImpressions | integer | – | Drop search terms below this many impressions |
| zeroConversionsOnly | boolean | – | Keep only terms that converted nothing, which is the list that feeds negative keywords |
| Name | Type | Req | Description |
|---|---|---|---|
| days | number | yes | – |
| notes | array | yes | – |
| rowCount | number | yes | – |
| searchTerms | array | yes | – |
No examples provided.
ads_update ~337
Change one Google Ads keyword bid, campaign daily budget, campaign status, ad status or keyword status. Pausing one keyword is its own kind because dropping a bid is not the same thing: the keyword stays eligible and goes on competing for the same budget. Spends money, so it is a dry run unless dryRun is false, it refuses a change that trips a guard unless confirm is true, and it re-reads the value after writing because an accepted request is not a stored value. Guards: more than three times the current amount, more than $25, or pausing something that is serving
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | – | Perform a change that trips a guard. Ignored on a dry run. The dry run lists the guard reasons, so this confirms something already read rather than something unseen |
| dryRun | boolean | – | Report what would change and which guards it trips, without changing anything. On by default: this tool spends money, so performing a change has to be asked for |
| kind | string | yes | What to change: a keyword's max CPC bid, a campaign's daily budget, a campaign's status, an ad's status, or a keyword's status. Use keywordStatus to stop one keyword serving; dropping its bid is not… |
| target | string | yes | The keyword text, the campaign name, or the numeric ad id. It must match exactly one thing or the call is refused |
| value | string | yes | The new amount in dollars for a bid or budget, or pause or enable for a status |
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | yes | – |
| applied | boolean | yes | – |
| before | string | yes | – |
| customerId | string | yes | – |
| guards | array | yes | – |
| kind | string | yes | – |
| matches | – | yes | Whether the re-read value equals what was sent |
| noOp | boolean | yes | – |
| readBack | – | yes | The value re-read from the account after the write. An accepted request is not proof of a stored value |
| target | string | yes | – |
No examples provided.
ads_update_batch ~238
Change several Google Ads keyword bids, or several campaign daily budgets, in one call. It is a named list of pairs, not a rule applied to many things: each entry names one target and the value it should end at, and an entry that matches no row or more than one refuses the whole batch before anything is written. The sum is guarded as well as each entry, because separately reasonable raises are one large spend change together. Dry run unless dryRun is false, and every value is read back afterwards
| Name | Type | Req | Description |
|---|---|---|---|
| changes | array | yes | A named list of pairs, each with its own value. There is no selector form: enumeration cannot make the mistake that a pattern can |
| confirm | boolean | – | Perform the batch even though a guard tripped. The dry run lists every reason, so this confirms something already read |
| dryRun | boolean | – | Resolve and price every entry and report the total, without changing anything |
| kind | string | yes | One kind per call. A summed guard is only honest inside one kind: bids and budgets sum to dollars, statuses do not, and mixing them makes the total unreadable |
| Name | Type | Req | Description |
|---|---|---|---|
| applied | boolean | yes | – |
| customerId | string | yes | – |
| entries | array | yes | – |
| kind | string | yes | – |
| notes | array | yes | – |
| totalAfter | number | yes | – |
| totalBefore | – | yes | Null when any entry has no current value to read, because a total that counts unknowns as zero is not a total |
| totalGuards | array | yes | Guards on the batch as a whole. Five individually reasonable raises are one large spend change, and doing them one at a time is how that gets missed |
| totalSummary | string | yes | The batch total in words, always present whether or not anything tripped. The sentence is what gets read; the guard is only what stops you when it is not |
No examples provided.
app_store_discovery ~186
Read the App Store surfaces beyond the listing text: search keywords, app tags, product page optimization experiments, custom product pages, in-app events, territory availability and review summarizations. A resource this key cannot read is reported as unavailable rather than as empty. Read-only
| Name | Type | Req | Description |
|---|---|---|---|
| appId | string | – | App Store Connect numeric app id; provide this or bundleId |
| bundleId | string | – | Bundle id; provide this or appId |
| include | array | – | Which discovery surfaces to read; empty reads all of them |
| includeRows | boolean | – | Include every raw row as well as the counts; off by default so a summary call stays small |
| limit | integer | – | Rows per resource |
| locales | array | – | Locales for per-locale resources such as searchKeywords |
| platform | string | – | Platform for resources that require one |
| Name | Type | Req | Description |
|---|---|---|---|
| appId | string | yes | – |
| bundleId | – | yes | – |
| locales | array | yes | – |
| notes | array | yes | – |
| resources | object | yes | – |
No examples provided.
app_store_listing ~189
Read an App Store listing's indexed fields per locale (name, subtitle, keywords) against Apple's character limits, plus promotional text, version state and star ratings. The ratings come from the public storefront lookup because App Store Connect exposes no aggregate rating; each entry names its source. Needs SEO_MCP_ASC_KEY_PATH, SEO_MCP_ASC_KEY_ID and SEO_MCP_ASC_ISSUER_ID; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| appId | string | – | App Store Connect numeric app id; provide this or bundleId |
| bundleId | string | – | Bundle id, resolved to an app id when appId is not given; provide this or appId |
| platform | string | – | App Store platform whose version is read |
| state | string | – | Read the live listing or the editable one being prepared for release |
| storefronts | array | – | Storefront country codes for the public ratings lookup |
| Name | Type | Req | Description |
|---|---|---|---|
| ageRating | – | yes | – |
| appId | string | yes | – |
| appInfoState | – | yes | – |
| bundleId | – | yes | – |
| categories | object | yes | – |
| fellBack | boolean | yes | – |
| hasEditableRecord | boolean | yes | – |
| hasLiveRecord | boolean | yes | – |
| localeCount | number | yes | – |
| locales | array | yes | – |
| notes | array | yes | – |
| overLimit | array | yes | – |
| phasedRelease | – | yes | – |
| platform | string | yes | – |
| ratings | array | yes | – |
| requestedState | string | yes | – |
| versionState | – | yes | – |
| versionString | – | yes | – |
No examples provided.
app_store_reviews ~155
Read App Store customer reviews and your responses, filtered by rating or storefront. Reports the mean and star split of the reviews actually fetched, which is not the app's lifetime rating; App Store Connect exposes no aggregate rating resource. Read-only
| Name | Type | Req | Description |
|---|---|---|---|
| appId | string | – | App Store Connect numeric app id; provide this or bundleId |
| bundleId | string | – | Bundle id; provide this or appId |
| limit | integer | – | Maximum reviews to return across pages |
| maxPages | integer | – | Maximum pages to follow |
| rating | array | – | Only these star ratings |
| sort | string | – | Sort order; newest first by default |
| territory | string | – | Only reviews from this storefront |
| Name | Type | Req | Description |
|---|---|---|---|
| appId | string | yes | – |
| bundleId | – | yes | – |
| filters | object | yes | – |
| histogramOfFetched | object | yes | – |
| meanOfFetched | – | yes | – |
| notes | array | yes | – |
| pagesRead | number | yes | – |
| returned | number | yes | – |
| reviews | array | yes | – |
| withoutResponse | number | yes | – |
No examples provided.
app_store_sales ~200
Read App Store Sales and Trends: units downloaded per day per territory per app, summarized by SKU. Needs SEO_MCP_ASC_VENDOR_NUMBER and a team key with Admin, Finance or Sales and Reports. A period with no sales is reported as an absence rather than an error. Read-only
| Name | Type | Req | Description |
|---|---|---|---|
| frequency | string | – | Report period |
| includeRows | boolean | – | Include every raw report row as well as the per-SKU summary |
| reportDate | string | – | Report date. DAILY and WEEKLY take YYYY-MM-DD (WEEKLY means the week's ending date), MONTHLY takes YYYY-MM, YEARLY takes YYYY. Defaults to the most recent complete period for the frequency |
| reportSubType | string | – | Report sub type |
| reportType | string | – | Sales and Trends report type |
| version | string | – | Report version, such as 1_0 or 1_3, when the default is not accepted |
| Name | Type | Req | Description |
|---|---|---|---|
| apps | array | yes | – |
| frequency | string | yes | – |
| hasData | boolean | yes | – |
| notes | array | yes | – |
| reportDate | string | yes | – |
| reportSubType | string | yes | – |
| reportType | string | yes | – |
| rowCount | number | yes | – |
| rows | array | yes | – |
| totalUnits | number | yes | – |
| vendorNumber | string | yes | – |
No examples provided.
audit_site ~87
Audit the on-page SEO of up to N pages from a sitemap and roll up the most common issues across the site. Takes a sitemap URL rather than a Search Console property, and needs no Google credentials
| Name | Type | Req | Description |
|---|---|---|---|
| concurrency | integer | – | Maximum page fetches in flight |
| maxPages | integer | – | Maximum pages to audit |
| sitemapUrl | string | yes | Public sitemap URL to audit |
| Name | Type | Req | Description |
|---|---|---|---|
| audited | number | yes | – |
| childSitemapsFailed | number | yes | – |
| childSitemapsSkipped | number | yes | – |
| failed | number | yes | – |
| pages | array | yes | – |
| rollup | object | yes | – |
| sitemapUrl | string | yes | – |
| skipped | number | yes | – |
| totalDiscovered | number | yes | – |
| truncated | boolean | yes | – |
No examples provided.
compare_search_periods ~113
Compare an analysis window with the preceding equal period to identify search gainers and losers
| Name | Type | Req | Description |
|---|---|---|---|
| by | string | – | Dimension used to compare performance |
| endDate | string | – | End date in YYYY-MM-DD; defaults to today |
| limit | integer | – | Maximum gainers and losers to return; defaults to 50 each |
| siteUrl | string | yes | Search Console property to analyze |
| startDate | string | – | Start date in YYYY-MM-DD; defaults to the latest 28-day window |
| Name | Type | Req | Description |
|---|---|---|---|
| currentTruncated | boolean | yes | Whether Search Console held more than 5000 rows for the current window |
| currentWindow | object | yes | Current comparison window |
| droppedAsUnknown | number | yes | Rows present on only one side whose other side was cut off, and so were excluded rather than counted as zero |
| gainers | array | yes | Rows with increased clicks |
| losers | array | yes | Rows with decreased clicks |
| previousTruncated | boolean | yes | Whether Search Console held more than 5000 rows for the previous window |
| previousWindow | object | yes | Immediately preceding equal-length window |
| siteUrl | string | yes | Search Console property analyzed |
No examples provided.
compare_snapshots ~131
Compare two snapshot documents and return the differences between them: clicks, impressions, positions, installs, ratings and locale counts. Reports arithmetic only, never whether a change was good or what caused it; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Snapshot file name or path inside the snapshot directory; latest names the newest snapshot on disk and previous the one before it |
| minImpressions | integer | – | Ignore page position moves below this many impressions on both sides |
| to | string | yes | Snapshot file name or path inside the snapshot directory; latest names the newest snapshot on disk and previous the one before it |
| Name | Type | Req | Description |
|---|---|---|---|
| apps | array | yes | – |
| argumentsReversed | boolean | yes | – |
| elapsedHours | – | yes | – |
| from | object | yes | – |
| minImpressions | number | yes | – |
| notes | array | yes | – |
| packages | array | yes | – |
| properties | array | yes | – |
| slugs | array | yes | – |
| surfacesWithErrors | array | yes | – |
| to | object | yes | – |
No examples provided.
crux_field_data ~165
Read real-user Core Web Vitals for an origin or URL from the Chrome UX Report: the current 28-day field record with p75s and histograms. Field data, not a lab test; PageSpeed's own field block is being discontinued. Needs SEO_MCP_CRUX_KEY or a PageSpeed key allowed to call the Chrome UX Report API; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| formFactor | string | – | Device class; omit for all form factors combined |
| metrics | array | – | Metric names to request; omit for all available |
| origin | string | – | Origin such as https://example.com; aggregates every page under it. Give origin or url, not both |
| url | string | – | A single page URL. Give origin or url, not both |
| Name | Type | Req | Description |
|---|---|---|---|
| collectionPeriod | object | – | – |
| formFactor | – | yes | – |
| hasData | boolean | yes | – |
| metrics | – | yes | – |
| normalizedUrl | – | – | – |
| notes | array | yes | – |
| origin | – | yes | – |
| source | string | yes | – |
| url | – | yes | – |
No examples provided.
crux_history ~164
Read the Chrome UX Report weekly history for an origin or URL, roughly six months of 28-day rolling windows, so a field metric can be seen trending rather than as one point. Read-only
| Name | Type | Req | Description |
|---|---|---|---|
| collectionPeriodCount | integer | – | Weekly periods to return, 1 to 40. Documented history is about six months; the API decides what it actually has |
| formFactor | string | – | Device class; omit for all form factors combined |
| metrics | array | – | Metric names to request; omit for all available |
| origin | string | – | Origin such as https://example.com; aggregates every page under it. Give origin or url, not both |
| url | string | – | A single page URL. Give origin or url, not both |
| Name | Type | Req | Description |
|---|---|---|---|
| collectionPeriods | array | – | – |
| formFactor | – | yes | – |
| hasData | boolean | yes | – |
| metrics | – | yes | – |
| normalizedUrl | – | – | – |
| notes | array | yes | – |
| origin | – | yes | – |
| periodCount | number | – | – |
| source | string | yes | – |
| url | – | yes | – |
No examples provided.
ctr_gaps ~130
Find high-impression queries or pages whose CTR trails peers at the same position for snippet rewrite prioritization
| Name | Type | Req | Description |
|---|---|---|---|
| by | string | – | Dimension used to identify CTR gaps |
| endDate | string | – | End date in YYYY-MM-DD; defaults to today |
| limit | integer | – | Maximum gaps to return; defaults to 50 |
| minImpressions | number | – | Minimum impressions required; defaults to 100 |
| siteUrl | string | yes | Search Console property to analyze |
| startDate | string | – | Start date in YYYY-MM-DD; defaults to the latest 28-day window |
| Name | Type | Req | Description |
|---|---|---|---|
| gaps | array | yes | Rows underperforming their position peers |
| siteUrl | string | yes | Search Console property analyzed |
| truncated | boolean | yes | Whether Search Console held more than 5000 rows for this window, so the list was computed from the top rows only |
| window | object | yes | Analysis window |
No examples provided.
delete_sitemap ~72
Remove a submitted sitemap from a Search Console property (write; supports dryRun)
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | If true, report what would be removed without writing to Search Console |
| feedpath | string | yes | Absolute URL of the sitemap to remove |
| siteUrl | string | yes | Search Console property |
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | – |
| feedpath | string | yes | – |
| siteUrl | string | yes | – |
| success | boolean | yes | – |
No examples provided.
index_coverage ~81
Check how many of a sitemap's pages are indexed by Google (bounded; respects URL Inspection quota)
| Name | Type | Req | Description |
|---|---|---|---|
| concurrency | integer | – | Concurrent URL Inspection requests |
| maxUrls | integer | – | Maximum URLs to inspect |
| siteUrl | string | yes | Search Console property containing the sitemap URLs |
| sitemapUrl | string | yes | Fully qualified sitemap URL to inspect |
| Name | Type | Req | Description |
|---|---|---|---|
| checked | number | yes | – |
| childSitemapsSkipped | number | yes | – |
| failed | number | yes | – |
| indexed | number | yes | – |
| notIndexed | array | yes | – |
| results | array | yes | – |
| siteUrl | string | yes | – |
| sitemapUrl | string | yes | – |
| totalDiscovered | number | yes | – |
| truncated | boolean | yes | – |
No examples provided.
indexnow_submit ~192
Submit changed URLs in bulk to IndexNow search engines: Bing, Yandex, Naver, Seznam, Yep; not Google. Needs an IndexNow key hosted on the site at https://<host>/<key>.txt (write; supports dryRun)
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | If true, report what would be submitted without notifying the endpoint |
| endpoint | string | – | IndexNow endpoint to notify; participating engines share submissions |
| key | string | – | IndexNow key; defaults to SEO_MCP_INDEXNOW_KEY. The same key must be hosted on the site as a text file at https://<host>/<key>.txt (or at keyLocation) containing only the key |
| keyLocation | string | – | URL of the hosted key file when it is not https://<host>/<key>.txt |
| urls | array | yes | Changed page URLs; one submission covers one host |
| Name | Type | Req | Description |
|---|---|---|---|
| dryRun | boolean | – | – |
| endpoint | string | yes | – |
| host | string | yes | – |
| note | string | yes | – |
| statusCode | – | yes | – |
| success | boolean | yes | – |
| urlCount | number | yes | – |
No examples provided.
inspect_url ~54
Inspect a URL's Google index status, canonical selection, mobile usability, and rich results
| Name | Type | Req | Description |
|---|---|---|---|
| inspectionUrl | string | yes | Fully qualified URL to inspect |
| siteUrl | string | yes | Search Console property containing the inspected URL |
| Name | Type | Req | Description |
|---|---|---|---|
| indexStatus | object | yes | – |
| inspectionUrl | string | yes | – |
| mobileUsability | – | yes | – |
| richResults | – | yes | – |
| siteUrl | string | yes | – |
No examples provided.
keyword_ideas ~131
Expand a seed with free Google Autocomplete suggestions and optionally cross-reference Search Console rankings; no extra API key needed
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | Autocomplete country passed as gl |
| days | integer | – | Search Console lookback window in days |
| expansions | array | – | Suggestion expansion families to run beyond the bare seed |
| language | string | – | Autocomplete interface language passed as hl |
| limit | integer | – | Maximum keyword ideas to return |
| seed | string | yes | Seed keyword to expand |
| siteUrl | string | – | Optional Search Console property used to identify queries already ranking |
| Name | Type | Req | Description |
|---|---|---|---|
| crossReferenced | boolean | yes | – |
| gscMatched | number | yes | – |
| ideas | array | yes | – |
| requestFailures | number | yes | – |
| returned | number | yes | – |
| seed | string | yes | – |
| totalFound | number | yes | – |
No examples provided.
list_properties ~23
List Google Search Console properties the service account can access, with permission levels
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | – |
| properties | array | yes | – |
No examples provided.
list_sitemaps ~33
List sitemaps submitted for a Google Search Console property
| Name | Type | Req | Description |
|---|---|---|---|
| siteUrl | string | yes | Search Console property |
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | – |
| siteUrl | string | yes | – |
| sitemaps | array | yes | – |
No examples provided.
list_snapshots ~99
List the snapshot documents already in the snapshot directory, newest first: when each was taken, the window it covers, and how many properties, apps, packages and plugins it holds. This is what says whether there is an earlier snapshot to compare against and what to name as from and to; a file that does not parse is listed with its error rather than hidden; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum snapshots to return, newest first |
| Name | Type | Req | Description |
|---|---|---|---|
| directory | string | yes | – |
| snapshots | array | yes | – |
| total | number | yes | – |
| truncated | boolean | yes | – |
No examples provided.
pagespeed ~83
Run PageSpeed Insights for field Core Web Vitals, Lighthouse scores, and top opportunities
| Name | Type | Req | Description |
|---|---|---|---|
| apiKey | string | – | Optional PageSpeed Insights API key; defaults to SEO_MCP_PAGESPEED_KEY |
| category | array | – | Lighthouse categories to run |
| strategy | string | – | Lighthouse device strategy |
| url | string | yes | Public page URL to analyze |
| Name | Type | Req | Description |
|---|---|---|---|
| fieldData | object | yes | – |
| opportunities | array | yes | – |
| scores | object | yes | – |
| strategy | string | yes | – |
| url | string | yes | – |
No examples provided.
play_store_stats ~359
Read Google Play bulk reports for an app: active device installs and store-listing visitors and acquisitions by traffic source. installsDimension picks which installs breakdown is read (overview, country, language, device, os_version, carrier or app_version), include adds the ratings, crashes and reviews report families, and startDate with endDate reads every month the window touches instead of the single month in month. Reads the reporting bucket named by SEO_MCP_PLAY_BUCKET; read-only
| Name | Type | Req | Description |
|---|---|---|---|
| crashesDimension | string | – | Dimension for the crashes report |
| endDate | string | – | Window end in YYYY-MM-DD |
| include | array | – | Extra report families to read. Missing files are normal: Google emits a report only when there is something to report |
| installsDimension | string | – | Which installs report to read. overview is undocumented by Google but present in real buckets; the others are the documented breakdowns |
| month | string | – | Report month as YYYYMM; defaults to the current UTC month. Ignored when startDate and endDate are given |
| packageName | string | yes | Android package name, e.g. app.getpsst |
| ratingsDimension | string | – | Dimension for the ratings report |
| startDate | string | – | Window start in YYYY-MM-DD. With endDate, reads every month the window touches and filters rows to it |
| storePerformanceDimension | string | – | Which store performance breakdown to read |
| storePerformanceTotals | boolean | – | Read the total_ variant instead. It is a different report, not a rollup of the same one: it carries acquisitions only, with no visitors and no conversion rate, and for some apps it covers far fewer d… |
| Name | Type | Req | Description |
|---|---|---|---|
| activeDeviceInstalls | – | yes | – |
| crashes | – | yes | – |
| datesPresent | array | yes | – |
| hasPlaySearchRows | boolean | yes | – |
| installsDimension | string | yes | – |
| installsLatest | – | yes | – |
| installsWindowTotals | object | yes | – |
| installsZeroThroughout | array | yes | – |
| lastDatePresent | – | yes | – |
| month | string | yes | – |
| monthsRead | array | yes | – |
| notes | array | yes | – |
| packageName | string | yes | – |
| ratings | – | yes | – |
| reviews | – | yes | – |
| storePerformanceDimension | string | yes | – |
| storePerformanceTotals | boolean | yes | – |
| trafficSources | array | yes | – |
| window | – | yes | – |
No examples provided.
play_vitals ~186
Read Android vitals from the Play Developer Reporting API: crash rate, ANR rate, error counts and startup metrics, daily or hourly, with optional breakdowns. Reports how fresh the data actually is. Carries no acquisition or conversion data; use play_store_stats for that. Read-only
| Name | Type | Req | Description |
|---|---|---|---|
| aggregationPeriod | string | – | DAILY is reported in America/Los_Angeles, HOURLY in UTC |
| days | integer | – | How many days back to query |
| dimensions | array | – | Breakdown dimensions such as versionCode or countryCode |
| includeRows | boolean | – | Include every raw row as well as the counts; off by default so a summary call stays small |
| metricSets | array | – | Which Android vitals metric sets to query |
| packageName | string | yes | Android package name |
| pageSize | integer | – | Rows per metric set |
| Name | Type | Req | Description |
|---|---|---|---|
| aggregationPeriod | string | yes | – |
| days | number | yes | – |
| metricSets | object | yes | – |
| notes | array | yes | – |
| packageName | string | yes | – |
No examples provided.
query_cannibalization ~100
Find queries served by multiple pages to prioritize consolidation and internal-linking decisions
| Name | Type | Req | Description |
|---|---|---|---|
| endDate | string | – | End date in YYYY-MM-DD; defaults to today |
| minImpressions | number | – | Minimum impressions per query-page row; defaults to 10 |
| siteUrl | string | yes | Search Console property to analyze |
| startDate | string | – | Start date in YYYY-MM-DD; defaults to the latest 28-day window |
| Name | Type | Req | Description |
|---|---|---|---|
| groups | array | yes | Queries with multiple ranking pages |
| siteUrl | string | yes | Search Console property analyzed |
| truncated | boolean | yes | Whether Search Console held more than 5000 rows for this window, so the list was computed from the top rows only |
| window | object | yes | Analysis window |
No examples provided.
request_recrawl ~162
Inspect URLs' Google index status and resubmit the covering sitemap for the ones not indexed, the supported bulk recrawl nudge (write; supports dryRun)
| Name | Type | Req | Description |
|---|---|---|---|
| concurrency | integer | – | Concurrent URL Inspection requests |
| dryRun | boolean | – | If true, inspect and report without resubmitting the sitemap |
| feedpath | string | – | Sitemap to resubmit when unindexed URLs are found; defaults to sitemapUrl |
| maxUrls | integer | – | Maximum sitemap URLs to inspect |
| siteUrl | string | yes | Search Console property containing the URLs |
| sitemapUrl | string | – | Sitemap to read URLs from; also the default sitemap to resubmit |
| urls | array | – | Explicit URLs to check; omit to read them from sitemapUrl |
| Name | Type | Req | Description |
|---|---|---|---|
| checked | number | yes | – |
| dryRun | boolean | – | – |
| failed | number | yes | – |
| indexed | number | yes | – |
| notIndexed | array | yes | – |
| resubmit | object | yes | – |
| results | array | yes | – |
| siteUrl | string | yes | – |
| totalDiscovered | number | yes | – |
| truncated | boolean | yes | – |
No examples provided.
search_analytics ~265
Query Google Search Console search analytics and return ranked clicks, impressions, CTR, and position
| Name | Type | Req | Description |
|---|---|---|---|
| aggregationType | string | – | How Search Console aggregates rows |
| dataState | string | – | full = finalized data (default, ~2-3 day lag); all = include recent partial data |
| dimensionFilterGroups | array | – | Search Console dimension filters |
| dimensions | array | – | Dimensions used to group results |
| endDate | string | – | End date in YYYY-MM-DD; defaults to today |
| maxTableRows | integer | – | Cap rows shown in the text table; structured rows are always complete. 0 = summary only. |
| rowLimit | integer | – | Maximum rows to return |
| siteUrl | string | yes | Search Console property, such as https://example.com/ or sc-domain:example.com |
| startDate | string | – | Start date in YYYY-MM-DD; defaults to 28 days ago |
| startRow | integer | – | Zero-based row to start from, for paging through a large result |
| type | string | – | Result type. discover is the Discover feed and googleNews is the Google News app and news.google.com, not the News tab in Search. Both support fewer dimensions than web: neither reports a query dimen… |
| Name | Type | Req | Description |
|---|---|---|---|
| dimensions | array | yes | – |
| endDate | string | yes | – |
| firstIncompleteDate | string | – | – |
| rowCount | number | yes | – |
| rows | array | yes | – |
| siteUrl | string | yes | – |
| startDate | string | yes | – |
| startRow | number | yes | – |
| truncated | boolean | yes | More rows follow this page. False does not mean the result is complete: Search Console returns top rows subject to its own internal limits |
No examples provided.
search_opportunities ~152
Find queries ranking just off page 1 with high impressions, the highest-ROI keywords to improve
| Name | Type | Req | Description |
|---|---|---|---|
| endDate | string | – | End date in YYYY-MM-DD; defaults to today |
| limit | integer | – | Maximum opportunities to return; defaults to 50 |
| maxPosition | number | – | Highest average position to include; defaults to 20 |
| minImpressions | number | – | Minimum impressions required; defaults to 10 |
| minPosition | number | – | Lowest average position to include; defaults to 5 |
| siteUrl | string | yes | Search Console property to analyze |
| startDate | string | – | Start date in YYYY-MM-DD; defaults to the latest 28-day window |
| Name | Type | Req | Description |
|---|---|---|---|
| opportunities | array | yes | Highest-value striking-distance rows |
| siteUrl | string | yes | Search Console property analyzed |
| truncated | boolean | yes | Whether Search Console held more than 5000 rows for this window, so the list was computed from the top rows only |
| window | object | yes | Analysis window |
No examples provided.
seo_audit ~35
Fetch and audit a web page's on-page SEO without Google credentials
| Name | Type | Req | Description |
|---|---|---|---|
| url | string | yes | Public page URL to audit |
| Name | Type | Req | Description |
|---|---|---|---|
| canonical | – | yes | – |
| h1 | object | yes | – |
| headingOutline | array | yes | – |
| httpStatus | number | yes | – |
| images | object | yes | – |
| issues | array | yes | – |
| lang | – | yes | – |
| links | object | yes | – |
| metaDescription | object | yes | – |
| metaRobots | – | yes | – |
| openGraph | object | yes | – |
| schemaTypes | array | yes | – |
| title | object | yes | – |
| object | yes | – | |
| url | string | yes | – |
| viewport | – | yes | – |
| wordCount | number | yes | – |
No examples provided.
What is the SEO Console MCP server?
SEO Console is an MCP server listed in the public MCP registry as io.github.ibrahimhajjaj/seo-console-mcp. Search Console, Google Ads, App Store, Google Play, WordPress.org and Core Web Vitals over MCP. This page covers its npm package (seo-console-mcp).
Is the SEO Console MCP server safe to use?
SEO Console scores 70 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the SEO Console MCP server expose?
SEO Console exposes 43 tools: search_analytics, keyword_ideas, search_opportunities, compare_search_periods, ctr_gaps, and 38 more. Their descriptions and schemas cost roughly 6,403 tokens of context every time the server is loaded.
Is the SEO Console MCP server still maintained?
SEO Console is still listed as active in the MCP registry. We last reached this channel on 25 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the SEO Console MCP server under?
SEO Console declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.