# Send Ahrefs Connection to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/ahrefs-connection",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ahrefs-connection",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "references/workflows.md",
      "references/capabilities.md",
      "references/setup.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### Ahrefs API

Access real-time Ahrefs SEO data directly through the Ahrefs API to analyze websites, research keywords, track rankings, and make data-driven SEO decisions.

### First-Time Setup

If this is your first time using the Ahrefs API, read references/setup.md for complete setup instructions. You'll need:

An Ahrefs account (Enterprise plan for full API access, or Lite+ for limited free test queries)
An API key from your Ahrefs workspace

After setup, return here for usage guidance.

### Core Capabilities

Ahrefs API provides access to:

Site Explorer - Domain metrics, backlinks, organic traffic, referring domains
Keywords Explorer - Search volume, keyword difficulty, SERP analysis, related keywords
Rank Tracker - Position tracking, visibility metrics, competitor rankings (requires pre-configured projects)
Site Audit - Technical SEO issues, crawl data, site health (requires pre-configured projects)
SERP Overview - Top 100 SERP results for any keyword
Batch Analysis - Process up to 100 targets per request
Brand Radar - Brand performance stats

For detailed capability reference, see references/capabilities.md.

### Authentication

All API requests require an API key passed via the Authorization header:

Authorization: Bearer YOUR_API_KEY

Store your API key securely. Consider using environment variables:

export AHREFS_API_KEY="your-api-key-here"

### 1. Understand the Request

Identify what SEO data is needed:

Domain/URL analysis → Site Explorer endpoints
Keyword data → Keywords Explorer endpoints
Position tracking → Rank Tracker endpoints (requires project)
Technical SEO → Site Audit endpoints (requires project)
SERP data → SERP Overview endpoints

### 2. Make API Requests

Use curl or similar tools to call the Ahrefs API. Base URL: https://api.ahrefs.com/v3

Example - Get domain overview:

curl -X GET "https://api.ahrefs.com/v3/site-explorer/domain-overview?target=example.com" \\
  -H "Authorization: Bearer $AHREFS_API_KEY"

Example - Keyword metrics:

curl -X GET "https://api.ahrefs.com/v3/keywords-explorer/overview?keyword=seo+tools&country=us" \\
  -H "Authorization: Bearer $AHREFS_API_KEY"

### 3. Process and Present Results

Parse JSON responses
Extract relevant metrics
Present data in clear, actionable formats
Highlight key insights and opportunities
Suggest next steps based on findings

### Keyword Research + Cross-Reference

User provides keyword list
Make batch API calls to Keywords Explorer
Parse and consolidate metrics (volume, difficulty, CPC)
Present analysis with prioritization recommendations

See references/workflows.md for detailed workflow patterns with example API calls.

### Competitive Analysis

Identify target domain and competitors
Call Site Explorer for each domain
Compare metrics (DR, organic traffic, referring domains)
Analyze top organic keywords
Identify content gaps
Provide actionable recommendations

### Site Audit Review

Note: Requires pre-configured Site Audit project in Ahrefs web interface.

Call Site Audit API for project data
Identify critical issues by severity
Prioritize fixes by impact
Provide technical recommendations

### Rate Limiting

60 requests per minute by default
API returns HTTP 429 if limit exceeded
Implement exponential backoff for retries

### API Unit Consumption

Each request consumes API units from your monthly allowance
Cost depends on the number of rows returned (minimum 50 units per request)
Track usage in Account settings → Limits and usage
Enterprise plans include units; additional units can be purchased

### Optimization Tips

Batch requests when possible (up to 100 targets)
Limit result rows using limit parameter
Select specific columns with select parameter to reduce costs
Cache results when appropriate
Use date ranges to limit historical data

### Plan-Specific Access

Enterprise: Full API access
Lite/Standard/Advanced: Limited free test queries (check your plan for specifics)

### Error Handling

Common HTTP status codes:

200 OK - Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing API key
403 Forbidden - Insufficient permissions or plan limits
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Ahrefs server issue

Always check response status and handle errors gracefully.

### When API Key is Missing

If the API key is not configured:

Provide setup instructions from references/setup.md
Guide through API key generation in Ahrefs Account settings
Explain how to securely store the key (environment variables recommended)
Test the connection with a simple API call

### Resources

API Documentation: https://docs.ahrefs.com/docs/api/reference/introduction
API Key Management: https://app.ahrefs.com/account/api-keys
Pricing & Limits: https://ahrefs.com/pricing
Limits & Usage Tracking: https://app.ahrefs.com/account/limits-and-usage/web
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jonathan-sokol
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/ahrefs-connection)
- [Send to Agent page](https://openagent3.xyz/skills/ahrefs-connection/agent)
- [JSON manifest](https://openagent3.xyz/skills/ahrefs-connection/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/ahrefs-connection/agent.md)
- [Download page](https://openagent3.xyz/downloads/ahrefs-connection)