{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ahrefs",
    "name": "Ahrefs Complete SEO Suite",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/geozhu/ahrefs",
    "canonicalUrl": "https://clawhub.ai/geozhu/ahrefs",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ahrefs",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ahrefs",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "INSTALL.md",
      "README.md",
      "references/api-endpoints.md",
      "references/batch-analysis.md",
      "references/brand-radar.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ahrefs"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ahrefs",
    "agentPageUrl": "https://openagent3.xyz/skills/ahrefs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ahrefs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ahrefs/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Ahrefs SEO Analysis",
        "body": "Query and analyze SEO data using the Ahrefs API for backlinks, keywords, rankings, and competitive intelligence."
      },
      {
        "title": "API Access",
        "body": "You need an Ahrefs subscription with API access:\n\nLite: Basic metrics, limited filtering\nStandard: More endpoints, some filtering\nAdvanced: Advanced filtering, more data\nEnterprise: Full API access, advanced filtering, high rate limits"
      },
      {
        "title": "Setup",
        "body": "Get your API token from Ahrefs Account Settings\n\n\nConfigure in OpenClaw:\nAdd to ~/.openclaw/workspace/.env:\nAHREFS_API_TOKEN=your_api_token_here\nAHREFS_API_PLAN=enterprise  # Options: lite, standard, advanced, enterprise\n\n\n\nVerify setup:\ngrep AHREFS ~/.openclaw/workspace/.env"
      },
      {
        "title": "All Plans",
        "body": "Domain Rating & Ahrefs Rank\nBasic backlinks stats (total counts)\nOrganic keywords count\nOrganic traffic estimates\nTop pages by traffic"
      },
      {
        "title": "Standard & Above",
        "body": "Organic keywords with positions (all positions)\nKeywords in positions 1-3 (via org_keywords_1_3 metric)\nReferring domains list (basic)"
      },
      {
        "title": "Advanced & Enterprise",
        "body": "Advanced filtering: Filter keywords by position (1-10 for first page)\nGeographic filtering: Filter backlinks by country/TLD (e.g., .au domains)\nDetailed keyword data: Access to best_position, sum_traffic, volume\nDetailed backlink data: Full backlinks list with filtering\nHigher rate limits: Fetch larger datasets (5000+ records)"
      },
      {
        "title": "Site Explorer (Domain Analysis)",
        "body": "Get comprehensive SEO metrics for any domain:\n\nDomain Rating (DR) & URL Rating (UR)\nOrganic traffic estimates\nReferring domains & backlinks\nOrganic keywords & rankings\nTop pages by traffic\nHistorical data & trends\n[Advanced/Enterprise] Filter by country/TLD\n[Advanced/Enterprise] Position-based filtering (first page only)"
      },
      {
        "title": "Keywords Explorer (Keyword Research)",
        "body": "Discover and analyze keywords:\n\nSearch volume (global & country-specific)\nKeyword difficulty (KD) score\nCost per click (CPC) estimates\nSERP analysis & features\nRelated keywords & questions\nKeyword ideas & suggestions\nParent topic analysis\nTraffic potential estimates"
      },
      {
        "title": "Rank Tracker (Position Monitoring)",
        "body": "Track keyword rankings over time:\n\nPosition tracking & visibility\nCompetitor rankings comparison\nSERP feature tracking\nHistorical position data\nShare of voice metrics\nNote: Requires pre-configured projects in Ahrefs"
      },
      {
        "title": "Site Audit (Technical SEO)",
        "body": "Identify technical SEO issues:\n\nCrawl data & site health scores\nOn-page issues by severity\nInternal link analysis\nPage performance metrics\nMobile usability issues\nNote: Requires pre-configured projects in Ahrefs"
      },
      {
        "title": "SERP Overview (Search Results)",
        "body": "Analyze search engine results:\n\nTop 100 organic results for any keyword\nSERP features present\nDomain metrics for ranking pages\nKeyword difficulty breakdown\nClick-through rate estimates"
      },
      {
        "title": "Batch Analysis (Bulk Processing)",
        "body": "Process multiple targets efficiently:\n\nAnalyze up to 100 domains/URLs per request\nBulk keyword metrics\nBatch backlink data\nCost-effective for large datasets"
      },
      {
        "title": "Brand Radar (Brand Monitoring)",
        "body": "Track brand performance:\n\nBrand mention metrics\nShare of voice\nCompetitor brand comparison\nSentiment analysis preparation"
      },
      {
        "title": "Competitor Analysis",
        "body": "Compare domains and identify opportunities:\n\nSide-by-side domain comparison\nContent gap analysis\nKeyword overlaps & differences\nBacklink gap analysis\nTraffic comparison\n[Advanced/Enterprise] Filtered comparisons (first page keywords, local backlinks)"
      },
      {
        "title": "API Structure",
        "body": "Ahrefs API base URL: https://api.ahrefs.com/v3/site-explorer/"
      },
      {
        "title": "Authentication",
        "body": "All requests require the API token in the header:\n\nAuthorization: Bearer {AHREFS_API_TOKEN}\n\nImportant: Use AHREFS_API_TOKEN, NOT AHREFS_MCP_TOKEN."
      },
      {
        "title": "Required Parameters",
        "body": "All API calls require:\n\ndate: Current date in format YYYY-MM-DD\ntarget: Domain (e.g., example.com)"
      },
      {
        "title": "Common Endpoints",
        "body": "For detailed endpoint documentation and parameters, see references/api-endpoints.md."
      },
      {
        "title": "Understanding API Units",
        "body": "Each API request consumes units from your monthly allowance\nCost depends on rows returned (minimum 50 units per request)\nEnterprise plans include units; additional units can be purchased\nTrack usage at: https://app.ahrefs.com/account/limits-and-usage/web"
      },
      {
        "title": "Cost Optimization Tips",
        "body": "Limit rows returned: Use limit parameter to reduce cost\nSelect specific columns: Use select parameter for only needed fields\nBatch requests: Process multiple targets in one call (up to 100)\nCache results: Store frequently accessed data locally\nUse date ranges: Limit historical data when not needed"
      },
      {
        "title": "Rate Limits",
        "body": "60 requests per minute (default)\nHTTP 429 returned if limit exceeded\nImplement exponential backoff for retries"
      },
      {
        "title": "Site Explorer - Get Backlinks & Referring Domains",
        "body": "DATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/backlinks-stats?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nReturns:\n\n{\n  \"metrics\": {\n    \"live\": 4545,\n    \"all_time\": 25318,\n    \"live_refdomains\": 718,\n    \"all_time_refdomains\": 3272\n  }\n}"
      },
      {
        "title": "Get Organic Keywords & Traffic",
        "body": "DATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/metrics?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nReturns:\n\n{\n  \"metrics\": {\n    \"org_keywords\": 6925,\n    \"org_traffic\": 38702,\n    \"org_keywords_1_3\": 1560,\n    \"org_cost\": 2372016\n  }\n}"
      },
      {
        "title": "Get Domain Rating",
        "body": "DATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/domain-rating?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nReturns:\n\n{\n  \"domain_rating\": {\n    \"domain_rating\": 43.0,\n    \"ahrefs_rank\": 1189155\n  }\n}"
      },
      {
        "title": "Get Top Pages",
        "body": "DATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/top-pages?date=$DATE&target=example.com&limit=10&select=url,sum_traffic\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\""
      },
      {
        "title": "Keywords Explorer - Keyword Research",
        "body": "curl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nReturns:\n\n{\n  \"keyword\": \"seo tools\",\n  \"volume\": 14000,\n  \"keyword_difficulty\": 75,\n  \"cpc\": 25.50,\n  \"serp_features\": [\"featured_snippet\", \"people_also_ask\"],\n  \"traffic_potential\": 18500\n}"
      },
      {
        "title": "Keywords Explorer - Related Keywords",
        "body": "curl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/related-keywords?keyword=seo+tools&country=us&limit=50\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\""
      },
      {
        "title": "SERP Overview - Analyze Search Results",
        "body": "curl -X GET \"https://api.ahrefs.com/v3/serp-overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nReturns top 100 organic results with domain metrics."
      },
      {
        "title": "Rank Tracker - Get Project Rankings",
        "body": "Note: Requires pre-configured project in Ahrefs web interface.\n\ncurl -X GET \"https://api.ahrefs.com/v3/rank-tracker/project?project_id=12345\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\""
      },
      {
        "title": "Site Audit - Get Project Issues",
        "body": "Note: Requires pre-configured project in Ahrefs web interface.\n\ncurl -X GET \"https://api.ahrefs.com/v3/site-audit/project?project_id=12345\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\""
      },
      {
        "title": "Batch Analysis - Multiple Domains",
        "body": "curl -X POST \"https://api.ahrefs.com/v3/site-explorer/batch/metrics\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"targets\": [\"example.com\", \"competitor1.com\", \"competitor2.com\"],\n    \"date\": \"2026-02-18\"\n  }'\n\nReturns metrics for all domains in one request."
      },
      {
        "title": "Keyword Research Workflow",
        "body": "Get keyword overview (volume, difficulty, CPC)\nFetch related keywords and questions\nAnalyze SERP for top-ranking content\nIdentify keyword difficulty and traffic potential\nExport prioritized keyword list"
      },
      {
        "title": "Competitive Analysis Workflow",
        "body": "Compare domain metrics (DR, traffic, keywords)\nAnalyze competitor backlink profiles\nIdentify content gaps\nFind keywords competitors rank for but you don't\nDiscover backlink opportunities"
      },
      {
        "title": "Technical SEO Audit Workflow",
        "body": "Requires Site Audit project\n\nFetch site health overview\nIdentify critical issues by severity\nAnalyze internal linking structure\nReview page performance metrics\nGenerate prioritized fix list"
      },
      {
        "title": "Content Strategy Workflow",
        "body": "Research target keywords (Keywords Explorer)\nAnalyze top-ranking content (SERP Overview)\nIdentify content gaps vs competitors\nPlan content based on traffic potential\nTrack rankings over time (Rank Tracker)"
      },
      {
        "title": "Batch Domain Analysis Workflow",
        "body": "Compile list of target domains\nMake batch API request (up to 100 domains)\nCompare metrics across all domains\nIdentify patterns and opportunities\nExport comparative analysis"
      },
      {
        "title": "Best Practices",
        "body": "Rate Limits: Respect API rate limits (60 req/min default)\nAPI Units: Monitor usage and optimize queries (limit rows, select columns)\nCaching: Cache responses for frequently accessed data\nPagination: Use limit and offset parameters for large datasets\nBatch Requests: Use batch endpoints when analyzing multiple targets\nError Handling: Check for 401 (auth), 429 (rate limit), 404 (not found)\nProject Requirements: Rank Tracker and Site Audit require pre-configured projects"
      },
      {
        "title": "Environment Variables",
        "body": "Load the token from the workspace .env file:\n\n# PowerShell\n$env:AHREFS_API_TOKEN = (Get-Content ~/.openclaw/workspace/.env -Raw | Select-String \"AHREFS_API_TOKEN=([^\\r\\n]+)\" | ForEach-Object { $_.Matches.Groups[1].Value })\n\n# Bash\nexport AHREFS_API_TOKEN=$(grep AHREFS_API_TOKEN ~/.openclaw/workspace/.env | cut -d'=' -f2)"
      },
      {
        "title": "Response Format",
        "body": "API responses vary by endpoint but typically return JSON:\n\nStats endpoints (backlinks-stats, metrics, domain-rating):\n\n{\n  \"metrics\": { /* metric fields */ },\n  \"domain_rating\": { /* rating fields */ }\n}\n\nList endpoints (top-pages, backlinks, etc.):\n\n{\n  \"pages\": [ /* array of results */ ],\n  \"backlinks\": [ /* array of results */ ]\n}"
      },
      {
        "title": "Authentication Errors",
        "body": "Verify token is correctly set in .env\nCheck token hasn't expired\nEnsure Bearer token format in header"
      },
      {
        "title": "Rate Limiting",
        "body": "Implement exponential backoff\nCache responses where appropriate\nUse batch endpoints when available"
      },
      {
        "title": "Data Not Found",
        "body": "Verify domain/URL format\nCheck if domain exists in Ahrefs index\nTry alternative target formats (with/without www)"
      }
    ],
    "body": "Ahrefs SEO Analysis\n\nQuery and analyze SEO data using the Ahrefs API for backlinks, keywords, rankings, and competitive intelligence.\n\nPrerequisites\nAPI Access\n\nYou need an Ahrefs subscription with API access:\n\nLite: Basic metrics, limited filtering\nStandard: More endpoints, some filtering\nAdvanced: Advanced filtering, more data\nEnterprise: Full API access, advanced filtering, high rate limits\nSetup\n\nGet your API token from Ahrefs Account Settings\n\nConfigure in OpenClaw: Add to ~/.openclaw/workspace/.env:\n\nAHREFS_API_TOKEN=your_api_token_here\nAHREFS_API_PLAN=enterprise  # Options: lite, standard, advanced, enterprise\n\n\nVerify setup:\n\ngrep AHREFS ~/.openclaw/workspace/.env\n\nPlan-Specific Features\nAll Plans\nDomain Rating & Ahrefs Rank\nBasic backlinks stats (total counts)\nOrganic keywords count\nOrganic traffic estimates\nTop pages by traffic\nStandard & Above\nOrganic keywords with positions (all positions)\nKeywords in positions 1-3 (via org_keywords_1_3 metric)\nReferring domains list (basic)\nAdvanced & Enterprise\nAdvanced filtering: Filter keywords by position (1-10 for first page)\nGeographic filtering: Filter backlinks by country/TLD (e.g., .au domains)\nDetailed keyword data: Access to best_position, sum_traffic, volume\nDetailed backlink data: Full backlinks list with filtering\nHigher rate limits: Fetch larger datasets (5000+ records)\nCore Capabilities\nSite Explorer (Domain Analysis)\n\nGet comprehensive SEO metrics for any domain:\n\nDomain Rating (DR) & URL Rating (UR)\nOrganic traffic estimates\nReferring domains & backlinks\nOrganic keywords & rankings\nTop pages by traffic\nHistorical data & trends\n[Advanced/Enterprise] Filter by country/TLD\n[Advanced/Enterprise] Position-based filtering (first page only)\nKeywords Explorer (Keyword Research)\n\nDiscover and analyze keywords:\n\nSearch volume (global & country-specific)\nKeyword difficulty (KD) score\nCost per click (CPC) estimates\nSERP analysis & features\nRelated keywords & questions\nKeyword ideas & suggestions\nParent topic analysis\nTraffic potential estimates\nRank Tracker (Position Monitoring)\n\nTrack keyword rankings over time:\n\nPosition tracking & visibility\nCompetitor rankings comparison\nSERP feature tracking\nHistorical position data\nShare of voice metrics\nNote: Requires pre-configured projects in Ahrefs\nSite Audit (Technical SEO)\n\nIdentify technical SEO issues:\n\nCrawl data & site health scores\nOn-page issues by severity\nInternal link analysis\nPage performance metrics\nMobile usability issues\nNote: Requires pre-configured projects in Ahrefs\nSERP Overview (Search Results)\n\nAnalyze search engine results:\n\nTop 100 organic results for any keyword\nSERP features present\nDomain metrics for ranking pages\nKeyword difficulty breakdown\nClick-through rate estimates\nBatch Analysis (Bulk Processing)\n\nProcess multiple targets efficiently:\n\nAnalyze up to 100 domains/URLs per request\nBulk keyword metrics\nBatch backlink data\nCost-effective for large datasets\nBrand Radar (Brand Monitoring)\n\nTrack brand performance:\n\nBrand mention metrics\nShare of voice\nCompetitor brand comparison\nSentiment analysis preparation\nCompetitor Analysis\n\nCompare domains and identify opportunities:\n\nSide-by-side domain comparison\nContent gap analysis\nKeyword overlaps & differences\nBacklink gap analysis\nTraffic comparison\n[Advanced/Enterprise] Filtered comparisons (first page keywords, local backlinks)\nAPI Structure\n\nAhrefs API base URL: https://api.ahrefs.com/v3/site-explorer/\n\nAuthentication\n\nAll requests require the API token in the header:\n\nAuthorization: Bearer {AHREFS_API_TOKEN}\n\n\nImportant: Use AHREFS_API_TOKEN, NOT AHREFS_MCP_TOKEN.\n\nRequired Parameters\n\nAll API calls require:\n\ndate: Current date in format YYYY-MM-DD\ntarget: Domain (e.g., example.com)\nCommon Endpoints\n\nFor detailed endpoint documentation and parameters, see references/api-endpoints.md.\n\nAPI Unit Management\nUnderstanding API Units\nEach API request consumes units from your monthly allowance\nCost depends on rows returned (minimum 50 units per request)\nEnterprise plans include units; additional units can be purchased\nTrack usage at: https://app.ahrefs.com/account/limits-and-usage/web\nCost Optimization Tips\nLimit rows returned: Use limit parameter to reduce cost\nSelect specific columns: Use select parameter for only needed fields\nBatch requests: Process multiple targets in one call (up to 100)\nCache results: Store frequently accessed data locally\nUse date ranges: Limit historical data when not needed\nRate Limits\n60 requests per minute (default)\nHTTP 429 returned if limit exceeded\nImplement exponential backoff for retries\nUsage Examples\nSite Explorer - Get Backlinks & Referring Domains\nDATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/backlinks-stats?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\n\nReturns:\n\n{\n  \"metrics\": {\n    \"live\": 4545,\n    \"all_time\": 25318,\n    \"live_refdomains\": 718,\n    \"all_time_refdomains\": 3272\n  }\n}\n\nGet Organic Keywords & Traffic\nDATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/metrics?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\n\nReturns:\n\n{\n  \"metrics\": {\n    \"org_keywords\": 6925,\n    \"org_traffic\": 38702,\n    \"org_keywords_1_3\": 1560,\n    \"org_cost\": 2372016\n  }\n}\n\nGet Domain Rating\nDATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/domain-rating?date=$DATE&target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\n\nReturns:\n\n{\n  \"domain_rating\": {\n    \"domain_rating\": 43.0,\n    \"ahrefs_rank\": 1189155\n  }\n}\n\nGet Top Pages\nDATE=$(date +%Y-%m-%d)\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/top-pages?date=$DATE&target=example.com&limit=10&select=url,sum_traffic\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nKeywords Explorer - Keyword Research\ncurl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\n\nReturns:\n\n{\n  \"keyword\": \"seo tools\",\n  \"volume\": 14000,\n  \"keyword_difficulty\": 75,\n  \"cpc\": 25.50,\n  \"serp_features\": [\"featured_snippet\", \"people_also_ask\"],\n  \"traffic_potential\": 18500\n}\n\nKeywords Explorer - Related Keywords\ncurl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/related-keywords?keyword=seo+tools&country=us&limit=50\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nSERP Overview - Analyze Search Results\ncurl -X GET \"https://api.ahrefs.com/v3/serp-overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\n\nReturns top 100 organic results with domain metrics.\n\nRank Tracker - Get Project Rankings\n\nNote: Requires pre-configured project in Ahrefs web interface.\n\ncurl -X GET \"https://api.ahrefs.com/v3/rank-tracker/project?project_id=12345\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nSite Audit - Get Project Issues\n\nNote: Requires pre-configured project in Ahrefs web interface.\n\ncurl -X GET \"https://api.ahrefs.com/v3/site-audit/project?project_id=12345\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\"\n\nBatch Analysis - Multiple Domains\ncurl -X POST \"https://api.ahrefs.com/v3/site-explorer/batch/metrics\" \\\n  -H \"Authorization: Bearer $AHREFS_API_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"targets\": [\"example.com\", \"competitor1.com\", \"competitor2.com\"],\n    \"date\": \"2026-02-18\"\n  }'\n\n\nReturns metrics for all domains in one request.\n\nCommon Workflows\nKeyword Research Workflow\nGet keyword overview (volume, difficulty, CPC)\nFetch related keywords and questions\nAnalyze SERP for top-ranking content\nIdentify keyword difficulty and traffic potential\nExport prioritized keyword list\nCompetitive Analysis Workflow\nCompare domain metrics (DR, traffic, keywords)\nAnalyze competitor backlink profiles\nIdentify content gaps\nFind keywords competitors rank for but you don't\nDiscover backlink opportunities\nTechnical SEO Audit Workflow\n\nRequires Site Audit project\n\nFetch site health overview\nIdentify critical issues by severity\nAnalyze internal linking structure\nReview page performance metrics\nGenerate prioritized fix list\nContent Strategy Workflow\nResearch target keywords (Keywords Explorer)\nAnalyze top-ranking content (SERP Overview)\nIdentify content gaps vs competitors\nPlan content based on traffic potential\nTrack rankings over time (Rank Tracker)\nBatch Domain Analysis Workflow\nCompile list of target domains\nMake batch API request (up to 100 domains)\nCompare metrics across all domains\nIdentify patterns and opportunities\nExport comparative analysis\nBest Practices\nRate Limits: Respect API rate limits (60 req/min default)\nAPI Units: Monitor usage and optimize queries (limit rows, select columns)\nCaching: Cache responses for frequently accessed data\nPagination: Use limit and offset parameters for large datasets\nBatch Requests: Use batch endpoints when analyzing multiple targets\nError Handling: Check for 401 (auth), 429 (rate limit), 404 (not found)\nProject Requirements: Rank Tracker and Site Audit require pre-configured projects\nEnvironment Variables\n\nLoad the token from the workspace .env file:\n\n# PowerShell\n$env:AHREFS_API_TOKEN = (Get-Content ~/.openclaw/workspace/.env -Raw | Select-String \"AHREFS_API_TOKEN=([^\\r\\n]+)\" | ForEach-Object { $_.Matches.Groups[1].Value })\n\n# Bash\nexport AHREFS_API_TOKEN=$(grep AHREFS_API_TOKEN ~/.openclaw/workspace/.env | cut -d'=' -f2)\n\nResponse Format\n\nAPI responses vary by endpoint but typically return JSON:\n\nStats endpoints (backlinks-stats, metrics, domain-rating):\n\n{\n  \"metrics\": { /* metric fields */ },\n  \"domain_rating\": { /* rating fields */ }\n}\n\n\nList endpoints (top-pages, backlinks, etc.):\n\n{\n  \"pages\": [ /* array of results */ ],\n  \"backlinks\": [ /* array of results */ ]\n}\n\nTroubleshooting\nAuthentication Errors\nVerify token is correctly set in .env\nCheck token hasn't expired\nEnsure Bearer token format in header\nRate Limiting\nImplement exponential backoff\nCache responses where appropriate\nUse batch endpoints when available\nData Not Found\nVerify domain/URL format\nCheck if domain exists in Ahrefs index\nTry alternative target formats (with/without www)"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/geozhu/ahrefs",
    "publisherUrl": "https://clawhub.ai/geozhu/ahrefs",
    "owner": "geozhu",
    "version": "1.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ahrefs",
    "downloadUrl": "https://openagent3.xyz/downloads/ahrefs",
    "agentUrl": "https://openagent3.xyz/skills/ahrefs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ahrefs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ahrefs/agent.md"
  }
}