Skip to main content

Semrush Advanced

SEO + MARKET INTELLIGENCE

Twenty-three explicit tools. Fewer schema-guessing loops.

Domains, keywords, backlinks, traffic, audiences, and projects with compound research briefs.

Semrush Advanced is a Quilr-built MCP for SEO, keyword, backlink, traffic, market and project research. It signs in with a Semrush API key, not an OAuth app.

Tools​

The MCP provides 23 tools, all read only. Its plural and batch tools accept several inputs in one call, keep input order and report failures per item.

CapabilityExamples
Account usageStandard API and Trends API unit balances
Domain researchDomain overview, organic and paid keywords, competitors, top pages, keyword gap
Keyword researchKeyword overview, ideas, questions, SERP results, opportunity briefs
Backlink researchBacklink overview, details, comparison and gap analysis
Traffic and market researchTraffic summaries, time series, channels, content, audience overlap and profiles
ProjectsList projects; read Position Tracking and Site Audit data
note

Database coverage, row limits and API unit cost depend on the Semrush subscription. Some traffic, market and Trends tools need a separate Trends API entitlement.

Setup​

You need a Semrush account with API access, enough API units for the reports you plan to run, and permission to store the key in QuilrAI.

1. Get the API key​

Sign in to Semrush, open Subscription Info > API Units and copy the API key. Treat it as a secret: it spends the account's API units.

2. Install from the Library​

  1. Go to Settings > AI Gateway > MCP Gateway, click Library and find Semrush Advanced.

  2. Click Set up and paste only the key as the Upstream API key, with no Bearer, quotes or spaces.

  3. Choose the Authentication scope:

    ScopeUse when
    Shared by the whole tenantOne approved Semrush account serves all authorized users. Everyone shares its unit balance, so restrict server access to the intended users and agents.
    Each user brings their ownUnit usage must be attributed to each user's own Semrush account.
  4. Click Install.

If Semrush Advanced is not in your Library, contact Quilr.

3. Verify​

Using Semrush Advanced, check my Semrush API unit balance. This is read-only.
Using Semrush Advanced, return a domain overview for example.com in the US database.
Limit the result size and tell me the estimated API-unit cost before running any
additional reports.

To verify batch behavior:

Using Semrush Advanced, compare domain overviews for example.com, example.org,
and example.net in one batch request. Keep the input order and report any
per-domain errors without failing the whole batch.

Use it effectively​

  • Prefer batch tools for several domains, keywords, projects or backlink targets.
  • Start with small row limits and expand only when the first result is useful.
  • Name the country database when geography matters.
  • Ask for an estimated upper bound before expensive or multi-target reports.
  • Consider a usage quota on a shared key to protect the unit balance.

Rotate or remove the key​

Rotate or replace the key in Semrush, update the saved credential in QuilrAI, re-run the unit-balance check, and revoke the old key under your credential policy.

Troubleshooting​

ErrorLikely causeFix
401 Unauthorized, or tools cannot be listedInvalid, revoked or wrongly pasted keyCopy the key again from Subscription Info > API Units and update the credential.
API unit balance is zeroNo units leftAdd units or use another approved account.
Report or database unavailableThe plan does not include itCheck the subscription and requested database.
Traffic or audience tools fail, SEO tools workNo Trends API accessAdd the Trends API entitlement or turn those tools off.
A batch partially failsSome inputs are invalid or exceed provider limitsRead the per-item results and retry only the failed inputs.
Higher unit cost than expectedLarge limits or many reportsReduce row limits, targets and date range.

References: Find your API key, Semrush API documentation.

Compared with the official server​

Provider-native

Choose official for raw report breadth

Use Semrush's MCP when analysts need the newest report inventory and are comfortable discovering and executing generic schemas.

  • Broad generic report discovery
  • Fastest access to new provider reports
Quilr-managed

Choose Quilr for agent-ready research

Use Quilr when the agent benefits from explicit schemas, compound briefs, comparison outputs, project batches, and visible quota boundaries.

  • Twenty-three named tools
  • Pre-composed SEO and market workflows
Decision signalExploration favors the official server; repeatable briefs and predictable automation favor Quilr Advanced.
CapabilitySemrush Official MCPQuilr Advanced
Broad generic report discovery✅-
Schema-driven execution✅-
Explicit operation schemas-✅ 23 tools
Domain research brief-✅
Keyword opportunity brief-✅
Native backlink and audience comparison✅ Reports✅ Agent-ready output
Keyword and backlink gaps✅✅
Batch project readsLimited✅
Standard and Trends quota visibility✅✅ Explicit

Choose the official server for the newest raw report breadth. Choose Quilr Advanced for predictable tools and pre-composed research workflows.