{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ahrefs-connection",
    "name": "Ahrefs Connection",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/jonathan-sokol/ahrefs-connection",
    "canonicalUrl": "https://clawhub.ai/jonathan-sokol/ahrefs-connection",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ahrefs-connection",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ahrefs-connection",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "references/workflows.md",
      "references/capabilities.md",
      "references/setup.md",
      "SKILL.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. 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. 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-connection"
    },
    "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-connection",
    "agentPageUrl": "https://openagent3.xyz/skills/ahrefs-connection/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ahrefs-connection/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ahrefs-connection/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. 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. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Ahrefs API",
        "body": "Access real-time Ahrefs SEO data directly through the Ahrefs API to analyze websites, research keywords, track rankings, and make data-driven SEO decisions."
      },
      {
        "title": "First-Time Setup",
        "body": "If this is your first time using the Ahrefs API, read references/setup.md for complete setup instructions. You'll need:\n\nAn Ahrefs account (Enterprise plan for full API access, or Lite+ for limited free test queries)\nAn API key from your Ahrefs workspace\n\nAfter setup, return here for usage guidance."
      },
      {
        "title": "Core Capabilities",
        "body": "Ahrefs API provides access to:\n\nSite Explorer - Domain metrics, backlinks, organic traffic, referring domains\nKeywords Explorer - Search volume, keyword difficulty, SERP analysis, related keywords\nRank Tracker - Position tracking, visibility metrics, competitor rankings (requires pre-configured projects)\nSite Audit - Technical SEO issues, crawl data, site health (requires pre-configured projects)\nSERP Overview - Top 100 SERP results for any keyword\nBatch Analysis - Process up to 100 targets per request\nBrand Radar - Brand performance stats\n\nFor detailed capability reference, see references/capabilities.md."
      },
      {
        "title": "Authentication",
        "body": "All API requests require an API key passed via the Authorization header:\n\nAuthorization: Bearer YOUR_API_KEY\n\nStore your API key securely. Consider using environment variables:\n\nexport AHREFS_API_KEY=\"your-api-key-here\""
      },
      {
        "title": "1. Understand the Request",
        "body": "Identify what SEO data is needed:\n\nDomain/URL analysis → Site Explorer endpoints\nKeyword data → Keywords Explorer endpoints\nPosition tracking → Rank Tracker endpoints (requires project)\nTechnical SEO → Site Audit endpoints (requires project)\nSERP data → SERP Overview endpoints"
      },
      {
        "title": "2. Make API Requests",
        "body": "Use curl or similar tools to call the Ahrefs API. Base URL: https://api.ahrefs.com/v3\n\nExample - Get domain overview:\n\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/domain-overview?target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_KEY\"\n\nExample - Keyword metrics:\n\ncurl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_KEY\""
      },
      {
        "title": "3. Process and Present Results",
        "body": "Parse JSON responses\nExtract relevant metrics\nPresent data in clear, actionable formats\nHighlight key insights and opportunities\nSuggest next steps based on findings"
      },
      {
        "title": "Keyword Research + Cross-Reference",
        "body": "User provides keyword list\nMake batch API calls to Keywords Explorer\nParse and consolidate metrics (volume, difficulty, CPC)\nPresent analysis with prioritization recommendations\n\nSee references/workflows.md for detailed workflow patterns with example API calls."
      },
      {
        "title": "Competitive Analysis",
        "body": "Identify target domain and competitors\nCall Site Explorer for each domain\nCompare metrics (DR, organic traffic, referring domains)\nAnalyze top organic keywords\nIdentify content gaps\nProvide actionable recommendations"
      },
      {
        "title": "Site Audit Review",
        "body": "Note: Requires pre-configured Site Audit project in Ahrefs web interface.\n\nCall Site Audit API for project data\nIdentify critical issues by severity\nPrioritize fixes by impact\nProvide technical recommendations"
      },
      {
        "title": "Rate Limiting",
        "body": "60 requests per minute by default\nAPI returns HTTP 429 if limit exceeded\nImplement exponential backoff for retries"
      },
      {
        "title": "API Unit Consumption",
        "body": "Each request consumes API units from your monthly allowance\nCost depends on the number of rows returned (minimum 50 units per request)\nTrack usage in Account settings → Limits and usage\nEnterprise plans include units; additional units can be purchased"
      },
      {
        "title": "Optimization Tips",
        "body": "Batch requests when possible (up to 100 targets)\nLimit result rows using limit parameter\nSelect specific columns with select parameter to reduce costs\nCache results when appropriate\nUse date ranges to limit historical data"
      },
      {
        "title": "Plan-Specific Access",
        "body": "Enterprise: Full API access\nLite/Standard/Advanced: Limited free test queries (check your plan for specifics)"
      },
      {
        "title": "Error Handling",
        "body": "Common HTTP status codes:\n\n200 OK - Success\n400 Bad Request - Invalid parameters\n401 Unauthorized - Invalid or missing API key\n403 Forbidden - Insufficient permissions or plan limits\n429 Too Many Requests - Rate limit exceeded\n500 Internal Server Error - Ahrefs server issue\n\nAlways check response status and handle errors gracefully."
      },
      {
        "title": "When API Key is Missing",
        "body": "If the API key is not configured:\n\nProvide setup instructions from references/setup.md\nGuide through API key generation in Ahrefs Account settings\nExplain how to securely store the key (environment variables recommended)\nTest the connection with a simple API call"
      },
      {
        "title": "Resources",
        "body": "API Documentation: https://docs.ahrefs.com/docs/api/reference/introduction\nAPI Key Management: https://app.ahrefs.com/account/api-keys\nPricing & Limits: https://ahrefs.com/pricing\nLimits & Usage Tracking: https://app.ahrefs.com/account/limits-and-usage/web"
      }
    ],
    "body": "Ahrefs API\n\nAccess real-time Ahrefs SEO data directly through the Ahrefs API to analyze websites, research keywords, track rankings, and make data-driven SEO decisions.\n\nFirst-Time Setup\n\nIf this is your first time using the Ahrefs API, read references/setup.md for complete setup instructions. You'll need:\n\nAn Ahrefs account (Enterprise plan for full API access, or Lite+ for limited free test queries)\nAn API key from your Ahrefs workspace\n\nAfter setup, return here for usage guidance.\n\nCore Capabilities\n\nAhrefs API provides access to:\n\nSite Explorer - Domain metrics, backlinks, organic traffic, referring domains\nKeywords Explorer - Search volume, keyword difficulty, SERP analysis, related keywords\nRank Tracker - Position tracking, visibility metrics, competitor rankings (requires pre-configured projects)\nSite Audit - Technical SEO issues, crawl data, site health (requires pre-configured projects)\nSERP Overview - Top 100 SERP results for any keyword\nBatch Analysis - Process up to 100 targets per request\nBrand Radar - Brand performance stats\n\nFor detailed capability reference, see references/capabilities.md.\n\nAuthentication\n\nAll API requests require an API key passed via the Authorization header:\n\nAuthorization: Bearer YOUR_API_KEY\n\n\nStore your API key securely. Consider using environment variables:\n\nexport AHREFS_API_KEY=\"your-api-key-here\"\n\nUsage Workflow\n1. Understand the Request\n\nIdentify what SEO data is needed:\n\nDomain/URL analysis → Site Explorer endpoints\nKeyword data → Keywords Explorer endpoints\nPosition tracking → Rank Tracker endpoints (requires project)\nTechnical SEO → Site Audit endpoints (requires project)\nSERP data → SERP Overview endpoints\n2. Make API Requests\n\nUse curl or similar tools to call the Ahrefs API. Base URL: https://api.ahrefs.com/v3\n\nExample - Get domain overview:\n\ncurl -X GET \"https://api.ahrefs.com/v3/site-explorer/domain-overview?target=example.com\" \\\n  -H \"Authorization: Bearer $AHREFS_API_KEY\"\n\n\nExample - Keyword metrics:\n\ncurl -X GET \"https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us\" \\\n  -H \"Authorization: Bearer $AHREFS_API_KEY\"\n\n3. Process and Present Results\nParse JSON responses\nExtract relevant metrics\nPresent data in clear, actionable formats\nHighlight key insights and opportunities\nSuggest next steps based on findings\nCommon Workflows\nKeyword Research + Cross-Reference\nUser provides keyword list\nMake batch API calls to Keywords Explorer\nParse and consolidate metrics (volume, difficulty, CPC)\nPresent analysis with prioritization recommendations\n\nSee references/workflows.md for detailed workflow patterns with example API calls.\n\nCompetitive Analysis\nIdentify target domain and competitors\nCall Site Explorer for each domain\nCompare metrics (DR, organic traffic, referring domains)\nAnalyze top organic keywords\nIdentify content gaps\nProvide actionable recommendations\nSite Audit Review\n\nNote: Requires pre-configured Site Audit project in Ahrefs web interface.\n\nCall Site Audit API for project data\nIdentify critical issues by severity\nPrioritize fixes by impact\nProvide technical recommendations\nAPI Limits & Best Practices\nRate Limiting\n60 requests per minute by default\nAPI returns HTTP 429 if limit exceeded\nImplement exponential backoff for retries\nAPI Unit Consumption\nEach request consumes API units from your monthly allowance\nCost depends on the number of rows returned (minimum 50 units per request)\nTrack usage in Account settings → Limits and usage\nEnterprise plans include units; additional units can be purchased\nOptimization Tips\nBatch requests when possible (up to 100 targets)\nLimit result rows using limit parameter\nSelect specific columns with select parameter to reduce costs\nCache results when appropriate\nUse date ranges to limit historical data\nPlan-Specific Access\nEnterprise: Full API access\nLite/Standard/Advanced: Limited free test queries (check your plan for specifics)\nError Handling\n\nCommon HTTP status codes:\n\n200 OK - Success\n400 Bad Request - Invalid parameters\n401 Unauthorized - Invalid or missing API key\n403 Forbidden - Insufficient permissions or plan limits\n429 Too Many Requests - Rate limit exceeded\n500 Internal Server Error - Ahrefs server issue\n\nAlways check response status and handle errors gracefully.\n\nWhen API Key is Missing\n\nIf the API key is not configured:\n\nProvide setup instructions from references/setup.md\nGuide through API key generation in Ahrefs Account settings\nExplain how to securely store the key (environment variables recommended)\nTest the connection with a simple API call\nResources\nAPI Documentation: https://docs.ahrefs.com/docs/api/reference/introduction\nAPI Key Management: https://app.ahrefs.com/account/api-keys\nPricing & Limits: https://ahrefs.com/pricing\nLimits & Usage Tracking: https://app.ahrefs.com/account/limits-and-usage/web"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jonathan-sokol/ahrefs-connection",
    "publisherUrl": "https://clawhub.ai/jonathan-sokol/ahrefs-connection",
    "owner": "jonathan-sokol",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ahrefs-connection",
    "downloadUrl": "https://openagent3.xyz/downloads/ahrefs-connection",
    "agentUrl": "https://openagent3.xyz/skills/ahrefs-connection/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ahrefs-connection/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ahrefs-connection/agent.md"
  }
}