semrush_get_ projectGet details for a single project (folder) by id: root URL, unicode domain, name, owner id, permission level, and the list of enabled tools.
Pull organic and paid keyword rankings for any domain, read Site Audit issues and Position Tracking campaigns, compare backlink profiles, and estimate a competitor's traffic by channel and country.
PopMCPSemrush
Every report, campaign and trigger this connection exposes — domain, keyword, URL, backlinks, Trends and Projects — searchable in one place.
semrush_get_ projectGet details for a single project (folder) by id: root URL, unicode domain, name, owner id, permission level, and the list of enabled tools.
semrush_list_ projectsList all Semrush projects (folders) in the account, with id, name, root URL, unicode domain, owner, permission, and which tools (Site Audit, Position Tracking, etc.) are enabled.
semrush_list_ tracking_ campaignsList the Position Tracking campaigns configured under a project, with their tracking URL, location, device, and campaign id.
semrush_position_ tracking_ overview_ organicPosition Tracking organic overview report for a campaign: aggregate ranking metrics (visibility, estimated traffic, average position, keywords in top positions) for your tracked organic keywords.
semrush_position_ tracking_ positions_ organicPosition Tracking organic positions report: the per-keyword current rankings for a campaign (keyword, position, position change, search volume, landing URL, and SERP features).
semrush_site_ audit_ infoGet the Site Audit campaign summary for a project: total health/score, error/warning/notice counts, pages crawled vs.
semrush_site_ audit_ issue_ pagesList the individual crawled pages affected by one specific Site Audit issue within a snapshot, with per-page detail columns.
semrush_site_ audit_ issuesList all detected issues for a given Site Audit snapshot: each issue's id, title, severity (error/warning/notice), and the count of affected pages.
semrush_site_ audit_ snapshotsList the historical Site Audit snapshots (crawl runs) for a project, each with its snapshot_id and finish date.
semrush_audience_ insightsAudience overlap between a target and selected competitor domains: overlap score, similarity score, shared user count and audience size.
semrush_geo_ distributionGeographic distribution of a target's traffic by country (or subcontinent/continent), showing traffic volume, share and engagement per region.
semrush_top_ pagesMost-visited pages (URLs) of the selected target with per-page traffic, desktop/mobile share and engagement.
semrush_traffic_ destinationsWebsites users visit after leaving the target domain (outbound journey), with the destination domain, traffic share and volume.
semrush_traffic_ sourcesInbound traffic sources for a target broken down by channel (direct, referral, search, social, paid, mail, display_ad) and by the specific referring domain/search engine, with traffic share and volume.
semrush_traffic_ summaryEstimated traffic overview for up to 200 domains/subdomains/subfolders at once: traffic rank, visits, unique visitors, pages per visit, time on site, bounce rate, desktop/mobile split, and channel breakdown.
semrush_backlinksList of individual backlinks pointing at the target, each with source page Authority Score (page_score), source URL/title, anchor text, target URL/title, external/internal link counts on the source page, link attributes (nofollow/sponsored/ugc), link type (text/image/form/frame), sitewide flag, new/lost flags, source HTTP response code, and first/last seen dates.
semrush_backlinks_ anchorsMost common anchor texts used in backlinks pointing to the target, each with the number of referring domains and backlinks using that anchor and first/last seen dates.
semrush_backlinks_ competitorsDomains with backlink profiles similar to the target (competitors by shared referring domains): each with Authority Score, similarity, count of common referring domains, total referring domains, and backlinks.
semrush_backlinks_ overviewAggregate backlink profile summary for a domain, subdomain, or URL: Authority Score, total backlinks, referring domains, referring URLs, referring IPs and Class C subnets, follow/nofollow/sponsored/UGC split, and link-type counts (text, image, form, frame).
semrush_backlinks_ pagesIndexed pages of the target ranked by their incoming backlinks: source page URL/title, referring domains and backlinks count, external/internal link counts, response code, and last/first seen.
semrush_backlinks_ refdomainsReferring domains linking to the target, each with its Authority Score (domain_ascore), number of backlinks from that domain, referring IP, country, and first/last seen dates.
semrush_backlinks_ v4_ linksv4 REST backlinks list: individual backlinks for a URL at a chosen scope, with anchor, source/target URL & title, page & domain Authority Scores, external/internal link counts, link attributes (nofollow/sponsored/ugc), type flags (image/form/frame), sitewide/new/lost flags, language, response code, and first/last seen.
semrush_backlinks_ v4_ overviewv4 REST backlinks overview: aggregate backlink metrics for a URL at a chosen scope (Authority Score, total backlinks, referring domains/URLs/IPs/Class-C subnets, follow/nofollow/sponsored/ugc, text/image/form/frame counts, new/lost).
semrush_domain_ organic_ competitorsOrganic competitors: domains competing with the target in organic search, ranked by competition level, with the number of common keywords and each competitor's own organic footprint.
semrush_domain_ organic_ keywordsDomain organic keywords: every keyword that brings the domain organic traffic from Google's top 100 results, with position, volume, CPC, traffic share, URL, SERP features, intent and trend.
semrush_domain_ paid_ competitorsPaid competitors: domains competing with the target in Google paid search, ranked by competition level, with common-keyword count and each competitor's paid footprint.
semrush_domain_ paid_ keywordsDomain paid (AdWords) keywords: keywords that bring users to the domain via Google paid search, with position, volume, CPC, ad copy title/description, visible/destination URL and traffic.
semrush_domain_ rankSingle-database domain overview: an one-row live or historical snapshot of a domain's organic, paid and SERP-feature footprint in one chosen regional database, including keyword position-distribution buckets.
semrush_domain_ ranksAll-database domain overview: live or historical organic + paid ranking summary for a domain across every regional Semrush database in one call (one row per database where the domain has presence).
semrush_domain_ vs_ domainDomain vs Domain: compare up to five domains by their common, unique or all keywords, returning each keyword's position in every compared domain side by side.
semrush_batch_ keyword_ overviewBatch keyword overview for one database: pass up to 100 phrases ';'-separated and get one row per phrase with search volume, CPC, competition, number of results and 12-month trend.
semrush_broad_ match_ keywordsBroad/phrase-match keyword variations for a seed phrase (full-text search of the keyword database): all keywords containing the seed terms, with search volume, CPC, competition, number of results, 12-month trend and triggered SERP features.
semrush_keyword_ difficultyKeyword Difficulty index (0..100) for one or more phrases, estimating how hard it is to rank organically.
semrush_keyword_ metricsSingle-keyword SEO and PPC metrics from the modern v4 REST endpoint: search volume, keyword difficulty, CPC, competitive density, number of results, search intents, SERP features, and a 12-month volume trend.
semrush_keyword_ overview_ one_ databaseKeyword overview for a single regional database: search volume, CPC, competition, number of organic results, and the 12-month trend for one phrase.
semrush_organic_ resultsDomains/URLs ranking organically in the top of Google for a given keyword: returns the organic SERP for the phrase with each domain's ranking URL, position and triggered SERP features.
semrush_phrase_ questionsQuestion keywords containing a seed phrase: question-format queries (how/what/why/...) that include the seed term, with search volume, CPC, competition, number of results and 12-month trend.
semrush_related_ keywordsRelated keywords for a seed phrase: semantically related terms with their search volume, CPC, competition, number of results, 12-month trend, relevance to the seed, and triggered SERP features.
semrush_url_ adwordsPaid keywords driving traffic to a specific URL: the keywords that trigger this exact URL as a Google Ads landing page, with position, search volume, CPC, traffic share, and the ad copy (title/text).
semrush_url_ organicOrganic keywords driving traffic to a specific URL: the keywords that rank that exact URL in Google's top-100 organic results, with position, search volume, CPC, traffic share, and SERP-feature flags.
semrush_url_ rankURL overview for a single regional database: aggregate organic and paid metrics for one exact URL (organic keyword count, organic traffic, organic cost, paid keyword count, paid traffic, paid budget) plus SERP-feature counts.
semrush_create_ projectCreate a new Semrush project (folder) for a domain.
semrush_delete_ projectPermanently delete a project (folder) by id.
semrush_list_ tracking_ locationsSearch the Position Tracking location database for a location_id by type and country.
semrush_position_ tracking_ add_ competitorsAdd competitor domains (up to 20) to an existing Position Tracking campaign so they appear in the competitors/visibility reports.
semrush_position_ tracking_ add_ keywordsAdd keywords (with optional tags) to track in an existing Position Tracking campaign.
semrush_position_ tracking_ competitors_ adwordsPosition Tracking AdWords (paid) competitors discovery report: domains competing with you in Google Ads for your tracked keywords.
semrush_position_ tracking_ competitors_ organicPosition Tracking organic competitors discovery report: domains competing with you on your tracked organic keywords, with their visibility/overlap metrics.
semrush_position_ tracking_ datesList the available Position Tracking snapshot dates for a campaign.
semrush_position_ tracking_ disable_ notificationsDisable weekly email notifications for a Position Tracking campaign.
semrush_position_ tracking_ enableCreate and configure a Position Tracking campaign on a project (target URL, location, device).
semrush_position_ tracking_ enable_ notificationsEnable weekly email delivery of Position Tracking campaign statistics.
semrush_position_ tracking_ landings_ adwordsPosition Tracking AdWords (paid) landing pages report: which URLs surface in Google Ads results for tracked keywords.
semrush_position_ tracking_ landings_ organicPosition Tracking organic landing pages report: which of your URLs rank for tracked organic keywords, with per-landing-page ranking metrics.
semrush_position_ tracking_ overview_ adwordsPosition Tracking AdWords (paid) overview report for a campaign: aggregate paid-ranking metrics for tracked keywords in Google Ads results.
semrush_position_ tracking_ positions_ adwordsPosition Tracking AdWords (paid) positions report: per-keyword paid rankings for a campaign in Google Ads results.
semrush_position_ tracking_ remove_ competitorsRemove competitor domains from an existing Position Tracking campaign.
semrush_position_ tracking_ remove_ keywordsRemove tracked keywords from an existing Position Tracking campaign.
semrush_position_ tracking_ visibility_ adwordsPosition Tracking AdWords (paid) visibility report: the campaign's paid-visibility trend over time for tracked keywords in Google Ads results.
semrush_position_ tracking_ visibility_ organicPosition Tracking organic visibility report: the campaign's visibility trend over time for tracked organic keywords (a CTR-weighted measure of ranking strength), filterable by SERP feature.
semrush_site_ audit_ editEdit an existing Site Audit campaign's crawl configuration (same settings as enable, plus JS rendering).
semrush_site_ audit_ enableEnable and configure the Site Audit tool on a project (creates the audit campaign with crawl settings).
semrush_site_ audit_ get_ pageGet the full Site Audit detail for one crawled page by its page id: all detected issues, status code, crawl depth and per-page metrics.
semrush_site_ audit_ historyGet the Site Audit campaign history: score and issue-count trend across past snapshots for a project, paginated.
semrush_site_ audit_ issue_ descriptionsGet the metadata catalog describing every Site Audit issue type: issue id, title, page-level title, and the column layout used when listing affected pages.
semrush_site_ audit_ launchStart a new Site Audit crawl (snapshot) for a project.
semrush_site_ audit_ page_ listList crawled pages from the latest Site Audit, filterable by URL mask, with per-page audit data (status, issues, depth).
semrush_site_ audit_ snapshot_ detailGet the detailed summary of one specific Site Audit snapshot (crawl run): overall score, issue counts, crawl coverage and timing for that single snapshot.
semrush_update_ projectRename an existing project (folder).
semrush_age_ and_ sex_ distributionDemographic breakdown of a target's audience by age band and sex, with user counts and shares per group.
semrush_audience_ interestsTop interest categories of a target's audience, with user counts and an affinity/interest score per category.
semrush_education_ distributionAudience breakdown by education level for a target, with user counts and shares per education group.
semrush_household_ distributionAudience breakdown by household size for a target, with user counts and shares per household-size group.
semrush_income_ distributionAudience breakdown by income level for a target, with user counts and shares per income group.
semrush_industry_ categoriesTop domains within an industry category by traffic, with full per-domain channel/demographic breakdown.
semrush_occupation_ distributionAudience breakdown by occupation for a target, with user counts and shares per occupation group.
semrush_purchase_ conversionPurchase conversion estimate for a target: the share of visitors that convert, by date/country/device.
semrush_social_ media_ distributionSocial media platform affinity of a target's audience: which social networks the audience uses, with affinity scores and user counts per platform (Facebook, Instagram, YouTube, TikTok, LinkedIn, Reddit, Twitter, Pinterest).
semrush_subdomainsTop subdomains of the selected website ranked by traffic, with per-subdomain visits/share by date and country.
semrush_subfoldersTop subfolders (URL path sections like /blog/, /shop/) of the selected website ranked by traffic, with per-subfolder visits/share by date and country.
semrush_traffic_ accuracyConfidence/accuracy level of the Traffic Analytics estimates for a target, by date/country/device.
semrush_traffic_ dailyDay-by-day traffic trend for a single target: visits, users, channel splits and engagement metrics broken out per day, with optional forecasted future days.
semrush_traffic_ rankTraffic rank of domains, returning the rank-to-domain mapping.
semrush_traffic_ weeklyWeek-by-week traffic trend for a single target: visits, users, channel splits and engagement metrics per week, with optional forecasted future weeks.
semrush_backlinks_ ascore_ profileDistribution of the target's referring domains and backlinks across Authority Score buckets (0-10, 11-20, ...
semrush_backlinks_ categoriesCategories (topics) of the domains referring to the target, each with a relevance/rating value.
semrush_backlinks_ categories_ profileTopical profile of the target's own categories based on its backlink profile, each with a relevance rating.
semrush_backlinks_ comparisonSide-by-side backlink-profile comparison across multiple targets (your domain vs competitors): Authority Score, total backlinks, referring domains and IPs per target.
semrush_backlinks_ geoDistribution of referring domains and backlinks by country (referring domains by country), derived from the referring domain IP location.
semrush_backlinks_ historicalMonthly historical trend of total backlinks and referring domains for the target over time.
semrush_backlinks_ matrixBacklink-intersect matrix across multiple targets (batch comparison): referring domains and how many of the supplied targets each domain links to (link-gap / prospecting matrix).
semrush_backlinks_ refipsReferring IP addresses sending backlinks to the target, each with country, number of referring domains and backlinks from that IP, and first/last seen dates.
semrush_backlinks_ tldDistribution of referring domains and backlinks by top-level domain zone (e.g.
semrush_backlinks_ v4_ ref_ domainsv4 REST referring domains: domains linking to a URL at a chosen scope, with domain Authority Score, backlinks count, referring IP, country, follow flag, new/lost flags, and first/last seen.
semrush_backlinks_ v4_ ref_ ipsv4 REST referring IPs: IP addresses sending backlinks to a URL at a chosen scope, with referring-domain and backlinks counts and country.
semrush_backlinks_ v4_ summaryv4 REST historical summary: monthly trend of Authority Score, total backlinks, referring domains and follow backlinks for a URL at a chosen scope.
semrush_domain_ organic_ pagesOrganic pages: the unique URLs on the domain that rank in Google's top 100 organic results, each with the number of organic keywords it ranks for, its estimated traffic and its share of the domain's organic traffic.
semrush_domain_ organic_ subdomainsOrganic subdomains: the subdomains of the target that rank in Google's top 100 organic results, each with the number of organic keywords it ranks for and its estimated organic traffic and traffic share.
semrush_domain_ paid_ ad_ copiesAds copies: the unique paid ad creatives (title, description, visible/destination URL) Semrush observed for the domain, each with the count of keywords that triggered it.
semrush_domain_ paid_ ad_ historyDomain ad history: for each keyword a domain has bid on in the last 12 months, the monthly paid position, CPC, volume, traffic and the ad copy shown - a time series of the domain's paid activity per keyword.
semrush_domain_ pla_ copiesPLA copies: the unique Product Listing Ad creatives (product title, price, destination URL) Semrush observed for the domain in Google Shopping, each with the count of keywords that triggered it.
semrush_domain_ pla_ keywordsDomain PLA / Shopping keywords: keywords that trigger the domain's Product Listing Ads in Google's paid (Shopping) results, with position, volume, product title, price and the product page URL.
semrush_domain_ rank_ historyDomain overview history: a monthly time series of a domain's organic/paid keyword counts, traffic and cost in one database; supports daily data for the last 31 days via display_daily.
semrush_rankSemrush Rank list: the most popular domains in a chosen database ranked by estimated traffic from Google's top 100 organic results (a leaderboard of top sites with their organic/paid metrics).
semrush_rank_ differenceWinners and losers: domains with the biggest gains and drops in keyword count, traffic and budget across Google's top 100 organic and paid results for a database, with the month-over-month delta columns.
semrush_keyword_ ads_ historyAds history for a keyword: domains that bid on the phrase in Google paid search over time, showing per-snapshot date, ad position, landing-page and visible URL, and the ad title/description.
semrush_keyword_ overview_ all_ databasesKeyword overview across ALL regional databases for one phrase: returns one row per database where the keyword has data, with search volume, CPC, competition, and number of organic results.
semrush_paid_ resultsDomains advertising on a given keyword in Google paid search: returns the paid SERP for the phrase with each advertiser's domain, visible (display) URL and landing-page URL.
semrush_url_ rank_ historyHistorical URL overview: month-by-month time series of a single URL's organic and paid aggregate metrics in one regional database.
semrush_url_ ranksURL overview across ALL regional databases at once: per-database organic and paid metrics for one exact URL, for multi-market analysis.
Credentials off one Semrush screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
Paste one API Key, copied from Account → Subscription info → the API Units tab. No OAuth redirect, client secret or token refresh. That one key reaches the Analytics API, the v4 REST endpoints, Trends and Projects.
••••••••••••3f7aRead-only keeps it to reports. Full access adds the 13 write operations, so hold approval for anything that changes a project, Site Audit or Position Tracking campaign. The full-catalog toggle loads the rarer reports.
Drop the PopMCP URL into Claude, ChatGPT, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Semrush credential never leaves the server.
app.popmcp.com/mcp/…Ask for something harmless before you turn writes on. Once it comes back clean, widen the tool set or switch the connection to full access.
How healthy is the marketing site right now and what errors are worst?
semrush_list_projectsok
Then just ask for the work
“How healthy is the marketing site right now and what errors are worst?”
“Run our 100-keyword launch list through volume, difficulty and intent for the US”
“Draft a content brief for 'invoice automation': questions, related terms, top SERP”
“Compare us to our top two organic rivals on keywords and referring domains”
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
FAQ
What teams ask before putting Semrush behind an AI client.
In Semrush, open Account → Subscription info → the API Units tab and copy the key shown there. Paste it into the single API Key field on the connect form. There is no OAuth redirect, no client secret and no token to refresh. The key is stored encrypted and travels server-side over HTTPS.
One key covers all of it. The same value reaches the Analytics API behind the domain, keyword, URL and backlinks reports, the v4 REST endpoints, Trends and Traffic Analytics, and the Projects API that backs Site Audit and Position Tracking. Projects is the largest module in this connection, so most of what an agent can do with campaigns lives there.
No. Each report is exposed as its own tool with defaults already set for column codes, the regional database and row limits, so a plain-English request resolves without you naming an export string. The semicolon-CSV responses Semrush returns are parsed into clean JSON before the agent reads them, which is the part that usually trips people up when they call this API directly.
It depends on the report. traffic_summary takes up to 200 domains, subdomains or subfolders in a single pass, domain_vs_domain compares up to five domains side by side with each keyword's position in every one, and batch_keyword_overview takes up to 100 phrases. Lists larger than those need more than one request.
110 operations across 6 API modules: Projects, Trends, Backlinks, Domain, Keyword and URL. 41 load into your AI client by default and the rest stay searchable, so a large catalog does not sit in context on every call. 97 of the operations read and only 13 write, and the writes are the ones worth putting behind approval.
Threshold watches cover organic traffic dropped, ranking keywords changed sharply, tracked keyword lost positions, search visibility dropped, site health score dropped, site errors climbing, backlinks lost, and website visits dropped. Each fires when the metric crosses a level you set, so a visibility slide or a spike in crawl errors reaches your agent instead of waiting for someone to open a dashboard.
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Any client that supports a remote Streamable HTTP MCP server — Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
Loading 110 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 41-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. You can switch a connection to the full catalog at any time.
A tool is something your AI calls — there are 110 here. A trigger is something PopMCP watches for you: 8 Semrush events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Semrush.
Launch a hosted MCP endpoint for Semrush, keep tool access under control, and start testing real workflow prompts right away.