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>
122 lines
2.7 KiB
Markdown
122 lines
2.7 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
GET https://api.semrush.com/?type=phrase_all&key={api_key}&export_columns=Ph,Nq,Cp,Co,Nr&phrase=keyword&database=us
|
|
```
|
|
|
|
### Related keywords
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
GET https://api.semrush.com/?type=phrase_kdi&key={api_key}&export_columns=Ph,Kd&phrase=keyword&database=us
|
|
```
|
|
|
|
### Backlinks overview
|
|
|
|
```bash
|
|
GET https://api.semrush.com/?type=backlinks_overview&key={api_key}&target=example.com&target_type=root_domain
|
|
```
|
|
|
|
### Backlinks list
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
- competitor-alternatives
|