# Run agents with Ahrefs

Ahrefs AI agents on Rush: connect Ahrefs once, then name it on any run. The agent works in its own cloud computer, with a record of every run.

[Connect Ahrefs](https://cloud.getrush.ai/console/settings/?section=connections) in the console under Settings → Connections.

## What an agent can do in Ahrefs

Query your Ahrefs SEO data. Uses your monthly Ahrefs API units and needs a Lite plan or higher.

## Jobs on Rush that use Ahrefs

- [Build a Backlink Report With Ahrefs](https://getrush.ai/run/backlink-report/ahrefs/)
- [Find Broken Backlinks With Ahrefs](https://getrush.ai/run/broken-backlinks/ahrefs/)
- [Find Content Gaps With Ahrefs](https://getrush.ai/run/content-gap-analysis/ahrefs/)
- [Run an SEO Audit on a Next.js Site](https://getrush.ai/run/seo-audit/nextjs/)

## Agents that use Ahrefs

- [SEO Audit: Technical and content SEO](https://getrush.ai/templates/seo-audit-8dc39700/)

## How Ahrefs connects

Ahrefs is a remote MCP server, published by Ahrefs, at `https://api.ahrefs.com/mcp/mcp`. Connecting it signs in through the MCP OAuth flow on Ahrefs's side.

From Ahrefs: [Ahrefs's MCP documentation](https://docs.ahrefs.com/docs/mcp/introduction).

Connect it once in the console under Settings → Connections, or from your server with `POST /me/connections`. The sign-in finishes in a browser signed in to the console as the same person, and a link not finished within 10 minutes expires.

After that, a run that names `ahrefs` in `connections`, or runs a saved agent that names it, gets it; your connections reach no run that does not name them.

```http
POST https://api.phoenix.so/me/connections

{
  "type": "mcp",
  "name": "Ahrefs",
  "url": "https://api.ahrefs.com/mcp/mcp"
}
```

## Whose Ahrefs account the agent uses

Your Ahrefs connection is personal: it belongs to the person who signed in. A run started in the console uses that person's Ahrefs, and a run started with an API key uses the Ahrefs of the member who created the key.

To act for your own app's users, make each user an agent from your template and show them, signed in to your app, the sign-in link `POST /o/{org}/agents/{agent}/connections` returns. They sign in to their own Ahrefs, and that agent's runs use their account and nothing else: never yours, never another user's.

## More Marketing integrations

- [Buffer](https://getrush.ai/integrations/buffer/)
- [Semrush](https://getrush.ai/integrations/semrush/)
- [Klaviyo](https://getrush.ai/integrations/klaviyo/)
- [Resend](https://getrush.ai/integrations/resend/)

## Frequently asked questions

### How do I connect Ahrefs to Rush?

Open Settings → Connections in the console and connect Ahrefs, or send `POST /me/connections` with `{"type":"mcp","name":"Ahrefs","url":"https://api.ahrefs.com/mcp/mcp"}` and open the `authorize_url` it returns while signed in to the console. The connection reads `pending` until the sign-in finishes, then `connected`.

### Does every run get my Ahrefs account?

No. A run gets your Ahrefs connection only when it names it in `connections` (`"connections": ["ahrefs"]`), or runs a saved agent that names it. A saved agent names its connections once, and every run of it gets them.

### What can an agent do in Ahrefs?

Query your Ahrefs SEO data. Uses your monthly Ahrefs API units and needs a Lite plan or higher. 4 published jobs use it; this page lists them.

### Can my app's users connect their own Ahrefs?

Yes. Make each user an agent from your template, and they sign in to their own Ahrefs through the link `POST /o/{org}/agents/{agent}/connections` returns. That agent's runs use their account alone.

## Keep reading

- [AI agents for marketing teams: every job and app for them](https://getrush.ai/solutions/marketing/)
- [How connections work: sign in once, then every run that names a connection gets it](https://getrush.ai/docs/concepts/connections/)
- [Start your first run from the developer API quickstart](https://getrush.ai/docs/quickstart/)
- [Pricing: one price per member, hours shared by the team](https://getrush.ai/pricing/)
- [How Rush compares with other cloud agents](https://getrush.ai/compare/)
- [Every app and MCP server Rush connects to](https://getrush.ai/integrations/)
