{
  "schemaVersion": "1.0",
  "item": {
    "slug": "linkswarm-api",
    "name": "LinkSwarm API",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Heyw00d/linkswarm-api",
    "canonicalUrl": "https://clawhub.ai/Heyw00d/linkswarm-api",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/linkswarm-api",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=linkswarm-api",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/linkswarm-api"
    },
    "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/linkswarm-api",
    "agentPageUrl": "https://openagent3.xyz/skills/linkswarm-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/linkswarm-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/linkswarm-api/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": "LinkSwarm API 🐝",
        "body": "Backlink exchange for AI agents. Build authority for any site your agent creates."
      },
      {
        "title": "What This Skill Does",
        "body": "Lets your agent:\n\nRegister domains with LinkSwarm network\nRequest backlinks (costs credits)\nContribute link slots (earns credits)\nCheck credit balance and placement status\nGet notified when links are placed"
      },
      {
        "title": "1. Get API Key",
        "body": "Register at https://linkswarm.ai/register/ or via API:\n\ncurl -X POST https://api.linkswarm.ai/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"your@email.com\"}'"
      },
      {
        "title": "2. Store in Auth",
        "body": "Add to your agent's auth-profiles.json or environment:\n\n{\n  \"linkswarm\": {\n    \"api_key\": \"sk_linkswarm_...\"\n  }\n}"
      },
      {
        "title": "API Reference",
        "body": "Base URL: https://api.linkswarm.ai\n\nAuth: Authorization: Bearer sk_linkswarm_..."
      },
      {
        "title": "Register a Site",
        "body": "POST /v1/sites\n{\n  \"domain\": \"mycoolsite.com\",\n  \"name\": \"My Cool Site\",\n  \"categories\": [\"tech\", \"ai\"]\n}"
      },
      {
        "title": "Verify Domain",
        "body": "POST /v1/sites/verify\n{\n  \"domain\": \"mycoolsite.com\",\n  \"method\": \"dns\"  # or \"meta\"\n}\n\nAdd TXT record: linkswarm-verify=<token> or meta tag to verify."
      },
      {
        "title": "Request Backlinks (Costs 1 Credit)",
        "body": "POST /v1/pool/request\n{\n  \"target_domain\": \"mycoolsite.com\",\n  \"target_page\": \"/\",\n  \"anchor_text\": \"My Cool Site\"\n}"
      },
      {
        "title": "Contribute Link Slots (Earns 1 Credit)",
        "body": "POST /v1/pool/contribute\n{\n  \"domain\": \"mycoolsite.com\",\n  \"page_url\": \"/resources/\",\n  \"max_links\": 3\n}"
      },
      {
        "title": "Check Status",
        "body": "GET /v1/pool/status\n\nReturns: credits, pending placements, verified links"
      },
      {
        "title": "List Your Sites",
        "body": "GET /v1/sites"
      },
      {
        "title": "Credit System",
        "body": "ActionCreditsRequest backlink-1Contribute slot+1Link verified+1 bonusReferral signup+3\n\nFree tier starts with 3 credits."
      },
      {
        "title": "Example: Full Agent Flow",
        "body": "import requests\n\nAPI = \"https://api.linkswarm.ai\"\nKEY = \"sk_linkswarm_...\"\nheaders = {\"Authorization\": f\"Bearer {KEY}\", \"Content-Type\": \"application/json\"}\n\n# 1. Register new site\nrequests.post(f\"{API}/v1/sites\", headers=headers, json={\n    \"domain\": \"myagentsite.com\",\n    \"categories\": [\"ai\", \"tools\"]\n})\n\n# 2. Contribute to earn credits\nrequests.post(f\"{API}/v1/pool/contribute\", headers=headers, json={\n    \"domain\": \"myagentsite.com\",\n    \"page_url\": \"/partners/\"\n})\n\n# 3. Request backlinks\nrequests.post(f\"{API}/v1/pool/request\", headers=headers, json={\n    \"target_domain\": \"myagentsite.com\",\n    \"anchor_text\": \"AI Tools Directory\"\n})\n\n# 4. Check status\nstatus = requests.get(f\"{API}/v1/pool/status\", headers=headers).json()\nprint(f\"Credits: {status['credits']['balance']}\")\nprint(f\"Pending: {status['pendingPlacements']}\")"
      },
      {
        "title": "Webhooks (Optional)",
        "body": "Register webhooks to get notified:\n\nPOST /v1/webhooks\n{\n  \"url\": \"https://your-agent.com/webhook\",\n  \"events\": [\"link.placed\", \"link.verified\", \"credits.low\"]\n}"
      },
      {
        "title": "Best Practices",
        "body": "Verify domains before requesting links\nContribute before requesting to build credits\nUse relevant categories for better matching\nSet up webhooks for autonomous operation"
      },
      {
        "title": "Rate Limits",
        "body": "60 requests/minute\n500 requests/hour\nBurst: 10 concurrent"
      },
      {
        "title": "Support",
        "body": "Docs: https://linkswarm.ai/docs/\nDiscord: https://discord.gg/6RzUpUbMFE\nAPI Status: https://api.linkswarm.ai/health"
      },
      {
        "title": "Why LinkSwarm?",
        "body": "Non-reciprocal matching - Links look natural to search engines\nVerified placements - Crawler confirms every backlink\nFair credit system - Contribute to receive\nGrowing network - 30+ quality sites\nAI-first - Built for autonomous agents\n\nYour agent builds the site. LinkSwarm builds the authority. 🐝"
      }
    ],
    "body": "LinkSwarm API 🐝\n\nBacklink exchange for AI agents. Build authority for any site your agent creates.\n\nWhat This Skill Does\n\nLets your agent:\n\nRegister domains with LinkSwarm network\nRequest backlinks (costs credits)\nContribute link slots (earns credits)\nCheck credit balance and placement status\nGet notified when links are placed\nQuick Start\n1. Get API Key\n\nRegister at https://linkswarm.ai/register/ or via API:\n\ncurl -X POST https://api.linkswarm.ai/waitlist \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\": \"your@email.com\"}'\n\n2. Store in Auth\n\nAdd to your agent's auth-profiles.json or environment:\n\n{\n  \"linkswarm\": {\n    \"api_key\": \"sk_linkswarm_...\"\n  }\n}\n\nAPI Reference\n\nBase URL: https://api.linkswarm.ai\n\nAuth: Authorization: Bearer sk_linkswarm_...\n\nRegister a Site\nPOST /v1/sites\n{\n  \"domain\": \"mycoolsite.com\",\n  \"name\": \"My Cool Site\",\n  \"categories\": [\"tech\", \"ai\"]\n}\n\nVerify Domain\nPOST /v1/sites/verify\n{\n  \"domain\": \"mycoolsite.com\",\n  \"method\": \"dns\"  # or \"meta\"\n}\n\n\nAdd TXT record: linkswarm-verify=<token> or meta tag to verify.\n\nRequest Backlinks (Costs 1 Credit)\nPOST /v1/pool/request\n{\n  \"target_domain\": \"mycoolsite.com\",\n  \"target_page\": \"/\",\n  \"anchor_text\": \"My Cool Site\"\n}\n\nContribute Link Slots (Earns 1 Credit)\nPOST /v1/pool/contribute\n{\n  \"domain\": \"mycoolsite.com\",\n  \"page_url\": \"/resources/\",\n  \"max_links\": 3\n}\n\nCheck Status\nGET /v1/pool/status\n\n\nReturns: credits, pending placements, verified links\n\nList Your Sites\nGET /v1/sites\n\nCredit System\nAction\tCredits\nRequest backlink\t-1\nContribute slot\t+1\nLink verified\t+1 bonus\nReferral signup\t+3\n\nFree tier starts with 3 credits.\n\nExample: Full Agent Flow\nimport requests\n\nAPI = \"https://api.linkswarm.ai\"\nKEY = \"sk_linkswarm_...\"\nheaders = {\"Authorization\": f\"Bearer {KEY}\", \"Content-Type\": \"application/json\"}\n\n# 1. Register new site\nrequests.post(f\"{API}/v1/sites\", headers=headers, json={\n    \"domain\": \"myagentsite.com\",\n    \"categories\": [\"ai\", \"tools\"]\n})\n\n# 2. Contribute to earn credits\nrequests.post(f\"{API}/v1/pool/contribute\", headers=headers, json={\n    \"domain\": \"myagentsite.com\",\n    \"page_url\": \"/partners/\"\n})\n\n# 3. Request backlinks\nrequests.post(f\"{API}/v1/pool/request\", headers=headers, json={\n    \"target_domain\": \"myagentsite.com\",\n    \"anchor_text\": \"AI Tools Directory\"\n})\n\n# 4. Check status\nstatus = requests.get(f\"{API}/v1/pool/status\", headers=headers).json()\nprint(f\"Credits: {status['credits']['balance']}\")\nprint(f\"Pending: {status['pendingPlacements']}\")\n\nWebhooks (Optional)\n\nRegister webhooks to get notified:\n\nPOST /v1/webhooks\n{\n  \"url\": \"https://your-agent.com/webhook\",\n  \"events\": [\"link.placed\", \"link.verified\", \"credits.low\"]\n}\n\nBest Practices\nVerify domains before requesting links\nContribute before requesting to build credits\nUse relevant categories for better matching\nSet up webhooks for autonomous operation\nRate Limits\n60 requests/minute\n500 requests/hour\nBurst: 10 concurrent\nSupport\nDocs: https://linkswarm.ai/docs/\nDiscord: https://discord.gg/6RzUpUbMFE\nAPI Status: https://api.linkswarm.ai/health\nWhy LinkSwarm?\nNon-reciprocal matching - Links look natural to search engines\nVerified placements - Crawler confirms every backlink\nFair credit system - Contribute to receive\nGrowing network - 30+ quality sites\nAI-first - Built for autonomous agents\n\nYour agent builds the site. LinkSwarm builds the authority. 🐝"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Heyw00d/linkswarm-api",
    "publisherUrl": "https://clawhub.ai/Heyw00d/linkswarm-api",
    "owner": "Heyw00d",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/linkswarm-api",
    "downloadUrl": "https://openagent3.xyz/downloads/linkswarm-api",
    "agentUrl": "https://openagent3.xyz/skills/linkswarm-api/agent",
    "manifestUrl": "https://openagent3.xyz/skills/linkswarm-api/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/linkswarm-api/agent.md"
  }
}