Agent skill

ahrefs

Ahrefs SEO API for backlink and keyword analysis. Use when user mentions "SEO", "backlinks", "domain rating", "keyword research", or asks about site metrics.

View SKILL.md on GitHub Repository
Stars 50
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/vm0-ai/vm0-skills/tree/main/ahrefs

SKILL.md

Ahrefs API

Access SEO data including backlink profiles, domain ratings, organic keywords, and site metrics with the Ahrefs API v3.

Official docs: https://docs.ahrefs.com

When to Use

  • Check domain or URL rating
  • Analyze backlink profiles and referring domains
  • Research organic keywords and rankings
  • Get site traffic estimates
  • Monitor competitor SEO metrics

Core APIs

Get Domain Rating

Get the domain rating for a target. Replace <target-domain> with the actual domain (e.g., ahrefs.com):

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/domain-rating?target=<target-domain>&date=2026-03-01" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '{domain_rating, ahrefs_rank}'

Docs: https://docs.ahrefs.com/reference/domain-rating

Get Backlinks Overview

Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/backlinks-stats?target=<target-domain>&date=2026-03-01&mode=subdomains" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '{live, all_time, live_refdomains, all_time_refdomains}'

Get Backlinks

Get individual backlinks for a target. Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/all-backlinks?target=<target-domain>&date=2026-03-01&mode=subdomains&limit=10&select=url_from,url_to,ahrefs_rank,domain_rating_source,anchor,first_seen,last_seen" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '.backlinks[] | {url_from, url_to, anchor, domain_rating_source}'

Docs: https://docs.ahrefs.com/reference/all-backlinks

Get Referring Domains

Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/refdomains?target=<target-domain>&date=2026-03-01&mode=subdomains&limit=10&select=domain,domain_rating,backlinks,first_seen,last_seen" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '.refdomains[] | {domain, domain_rating, backlinks}'

Get Organic Keywords

Get keywords a domain ranks for organically. Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/organic-keywords?target=<target-domain>&date=2026-03-01&country=us&mode=subdomains&limit=10&select=keyword,position,volume,url,traffic" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '.keywords[] | {keyword, position, volume, traffic, url}'

Docs: https://docs.ahrefs.com/reference/organic-keywords

Get Organic Traffic Overview

Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/metrics?target=<target-domain>&date=2026-03-01&mode=subdomains" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '{organic_traffic, organic_keywords, organic_cost, paid_traffic, paid_keywords}'

Get URL Rating

Get URL rating for a specific page. Replace <target-url> with the full URL:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/url-rating?target=<target-url>&date=2026-03-01" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '{url_rating, ahrefs_rank}'

Get Top Pages

Get top pages by organic traffic. Replace <target-domain> with the actual domain:

bash
curl -s "https://api.ahrefs.com/v3/site-explorer/top-pages?target=<target-domain>&date=2026-03-01&country=us&mode=subdomains&limit=10&select=url,traffic,keywords,top_keyword,position" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '.pages[] | {url, traffic, keywords, top_keyword, position}'

Keywords Explorer - Volume

Get search volume for specific keywords. Replace <keyword> in the request:

Write to /tmp/ahrefs_request.json:

json
{
  "keywords": ["seo tools", "backlink checker"],
  "country": "us"
}
bash
curl -s -X POST "https://api.ahrefs.com/v3/keywords-explorer/volume?select=keyword,volume,difficulty,cpc,global_volume" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" --header "Content-Type: application/json" -d @/tmp/ahrefs_request.json | jq '.keywords[] | {keyword, volume, difficulty, cpc}'

Get Limits (Check API Usage)

bash
curl -s "https://api.ahrefs.com/v3/subscription-info" --header "Authorization: Bearer $(printenv AHREFS_TOKEN)" | jq '{rows_limit, rows_left, subscription}'

Guidelines

  1. Date parameter: Most endpoints require a date parameter in YYYY-MM-DD format; use recent dates for current data
  2. Mode: Use subdomains to include all subdomains, domain for exact domain, prefix for URL prefix, exact for exact URL
  3. Country codes: Use ISO 3166-1 alpha-2 codes (us, gb, de, etc.) for country-specific data
  4. Select parameter: Specify fields to return with select to reduce response size
  5. Rate limits: API usage is metered by rows returned; check /v3/subscription-info for remaining quota
  6. Limits: Use limit and offset for pagination (max 1000 per request)

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

vm0-ai/vm0-skills

brave-search

Brave Search API for web search. Use when user says "search web", "Brave search", or asks to "find on web" without specifying Google.

50 8
Explore
vm0-ai/vm0-skills

supadata

Supadata API for YouTube/web data. Use when user mentions "Supadata", "YouTube data", "channel stats", or web scraping data.

50 8
Explore
vm0-ai/vm0-skills

roadmap-planning

Build and prioritize product roadmaps using scoring models like RICE, ICE, and value-effort matrices. Activate when creating a product roadmap, prioritizing features, sequencing initiatives, mapping dependencies, balancing team capacity, choosing between Now/Next/Later or quarterly planning, or communicating roadmap tradeoffs to executives and stakeholders.

50 8
Explore
vm0-ai/vm0-skills

qdrant

Qdrant API for vector search. Use when user mentions "Qdrant", "vector database", "semantic search", or embeddings storage.

50 8
Explore
vm0-ai/vm0-skills

calendly

Calendly scheduling API. Use when user mentions "Calendly", "calendly.com", "schedule a meeting", "booking link", "event types", or asks about interview scheduling.

50 8
Explore
vm0-ai/vm0-skills

stripe

Stripe API for payments. Use when user mentions "Stripe", "payment", "subscription", "billing", "invoice", or asks about payment processing.

50 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results