Files
marketingskills/tools/integrations/semrush.md
Corey Haines edcc34aa6d feat: add marketing tools registry for agent discovery
Create centralized tools/ directory with REGISTRY.md index and 29
integration guides covering analytics, SEO, CRM, payments, referral,
email, ads, automation, and commerce platforms.

Each guide includes API endpoints, authentication, common operations,
and links to relevant skills. Updated AGENTS.md and key skills
(referral-program, analytics-tracking, email-sequence, paid-ads)
with tool integration references.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 18:33:51 -08:00

2.7 KiB

SEMrush

SEO and competitive analysis platform for keyword research and site audits.

Capabilities

Integration Available Notes
API Analytics API, Projects API
MCP - Not available
CLI - Not available
SDK - API-only

Authentication

  • Type: API Key
  • Parameter: key={api_key} in query string
  • Get key: My Profile > API in SEMrush dashboard

Common Agent Operations

Domain overview

GET https://api.semrush.com/?type=domain_ranks&key={api_key}&export_columns=Db,Dn,Rk,Or,Ot,Oc,Ad,At,Ac&domain=example.com

Organic keywords

GET https://api.semrush.com/?type=domain_organic&key={api_key}&export_columns=Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr&domain=example.com&database=us&display_limit=100

Keyword overview

GET https://api.semrush.com/?type=phrase_all&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr&phrase=keyword&database=us
GET https://api.semrush.com/?type=phrase_related&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr,Td&phrase=keyword&database=us&display_limit=50

Keyword difficulty

GET https://api.semrush.com/?type=phrase_kdi&key={api_key}&export_columns=Ph,Kd&phrase=keyword&database=us
GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain
GET https://api.semrush.com/?type=backlinks&key={api_key}&target=example.com&target_type=root_domain&export_columns=source_url,source_title,target_url,anchor&display_limit=100

Competitors

GET https://api.semrush.com/?type=domain_organic_organic&key={api_key}&export_columns=Dn,Cr,Np,Or,Ot,Oc,Ad&domain=example.com&database=us&display_limit=20

Response Format

Responses are CSV by default. Add &export_escape=1 for proper escaping.

Export Columns

Domain Report

  • Db - Database
  • Dn - Domain
  • Rk - Rank
  • Or - Organic keywords
  • Ot - Organic traffic
  • Oc - Organic cost

Keyword Report

  • Ph - Phrase/keyword
  • Nq - Search volume
  • Cp - CPC
  • Co - Competition
  • Kd - Keyword difficulty
  • Nr - Number of results
  • source_url - Linking page
  • target_url - Target page
  • anchor - Anchor text
  • source_title - Page title

Databases

Use country code: us, uk, de, fr, ca, au, etc.

When to Use

  • Keyword research
  • Competitive analysis
  • Backlink analysis
  • Site audits
  • Rank tracking
  • Content gap analysis

Rate Limits

  • Varies by plan (10-30K units/day)
  • Each API call costs units

Relevant Skills

  • seo-audit
  • programmatic-seo
  • content-strategy
  • competitor-alternatives