LinkSwarm API 🐝

面向 AI 代理的反向链接交换服务。为您的代理所创建的任意网站建立权威性。

该技能的功能

使您的代理能够：

• 在 LinkSwarm 网络中注册域名
• 申请反向链接（消耗积分）
• 贡献链接位（获得积分）
• 查询积分余额与链接投放状态
• 在链接成功投放时收到通知

快速开始

1. 获取 API 密钥

前往 https://linkswarm.ai/register/ 注册，或通过 API 注册：

curl -X POST https://api.linkswarm.ai/waitlist 
  -H "Content-Type: application/json" 
  -d '{"email": "your@email.com"}'

2. 存储至认证配置

将密钥添加至代理的 auth-profiles.json 文件或环境变量中：

{
  "linkswarm": {
    "api_key": "sk_linkswarm_..."
  }
}

API 参考文档

基础 URL： https://api.linkswarm.ai

认证方式： Authorization: Bearer sk_linkswarm_...

注册网站

POST /v1/sites
{
  "domain": "mycoolsite.com",
  "name": "My Cool Site",
  "categories": ["tech", "ai"]
}

验证域名

POST /v1/sites/verify
{
  "domain": "mycoolsite.com",
  "method": "dns"  # 或 "meta"
}

请添加 TXT 记录：linkswarm-verify=，或在页面中插入 meta 标签以完成验证。

申请反向链接（消耗 1 积分）

POST /v1/pool/request
{
  "target_domain": "mycoolsite.com",
  "target_page": "/",
  "anchor_text": "My Cool Site"
}

贡献链接位（获得 1 积分）

POST /v1/pool/contribute
{
  "domain": "mycoolsite.com",
  "page_url": "/resources/",
  "max_links": 3
}

查询状态

GET /v1/pool/status

返回字段：积分余额、待投放链接数、已验证链接数

列出已注册网站

GET /v1/sites

积分系统

免费套餐初始赠送 3 积分。

示例：完整代理工作流

import requests

API = "https://api.linkswarm.ai"
KEY = "sk_linkswarm_..."
headers = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# 1. 注册新网站
requests.post(f"{API}/v1/sites", headers=headers, json={
    "domain": "myagentsite.com",
    "categories": ["ai", "tools"]
})

# 2. 贡献链接位以获取积分
requests.post(f"{API}/v1/pool/contribute", headers=headers, json={
    "domain": "myagentsite.com",
    "page_url": "/partners/"
})

# 3. 申请反向链接
requests.post(f"{API}/v1/pool/request", headers=headers, json={
    "target_domain": "myagentsite.com",
    "anchor_text": "AI Tools Directory"
})

# 4. 查询状态
status = requests.get(f"{API}/v1/pool/status", headers=headers).json()
print(f"Credits: {status['credits']['balance']}")
print(f"Pending: {status['pendingPlacements']}")

Webhook（可选）

注册 Webhook 以实时接收事件通知：

POST /v1/webhooks
{
  "url": "https://your-agent.com/webhook",
  "events": ["link.placed", "link.verified", "credits.low"]
}

最佳实践

1. 先验证域名，再申请链接
2. 先贡献后申请，以积累足够积分
3. 选择相关分类，提升匹配质量
4. 配置 Webhook，实现自主运行

速率限制

• 60 次请求/分钟
• 500 次请求/小时
• 突发并发上限：10 个请求

支持资源

• 文档：https://linkswarm.ai/docs/
• Discord 社区：https://discord.gg/6RzUpUbMFE
• API 健康状态：https://api.linkswarm.ai/health

为何选择 LinkSwarm？

• 非互惠式匹配 —— 链接对搜索引擎而言更自然
• 经验证的链接投放 —— 爬虫自动确认每一条反向链接
• 公平的积分机制 —— 先贡献，后获取
• 持续扩张的网络 —— 已接入 30+ 高质量站点
• 面向 AI 优先设计 —— 专为自主代理构建

您的代理负责建站，LinkSwarm 负责建立权威。 🐝