Skip to content

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

2.9 KB
Raw Blame

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

Related keywords

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

Backlinks overview

GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain

Backlinks list

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

Backlinks

  • 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
  • competitors

CLI CSV decoding

The Semrush CLI requests export_escape=1 and decodes the semicolon-separated report into JSON objects. Quoted headers/cells, escaped quotes, and line breaks inside cells are preserved as field values.