API — AgentRank

Query the AgentRank index programmatically. All endpoints are free, unauthenticated, and CORS-enabled.

Base URL: https://agentrank-ai.com

GET /api/search

Search the index for skills and tools by keyword.

Parameters

Param	Type	Required	Description
`q`	string	Yes	Search query
`type`	string	No	`tool` or `skill`. Omit to search both.
`limit`	number	No	1–50, default 10

Example

curl "https://agentrank-ai.com/api/search?q=playwright&limit=3"

Response

{
  "query": "playwright",
  "results": [
    {
      "type": "skill",
      "slug": "glama:playwright-mcp-server",
      "name": "Playwright MCP Server",
      "description": "Browser automation and testing via Playwright",
      "score": 82.4,
      "rank": 12,
      "url": "https://agentrank-ai.com/skill/glama-playwright-mcp-server/"
    },
    {
      "type": "tool",
      "slug": "microsoft/playwright-mcp",
      "name": "microsoft/playwright-mcp",
      "description": "Playwright Tools for MCP",
      "score": 78.1,
      "rank": 34,
      "url": "https://agentrank-ai.com/tool/microsoft/playwright-mcp/"
    }
  ]
}

Cache: 5min CDN / 1min browser

GET /api/lookup

Look up a specific entry by its GitHub URL.

Parameters

Param	Type	Required	Description
`url`	string	Yes	GitHub repository URL

Example

curl "https://agentrank-ai.com/api/lookup?url=https://github.com/microsoft/playwright-mcp"

Response (found)

{
  "found": true,
  "type": "skill",
  "slug": "glama:playwright-mcp-server",
  "name": "Playwright MCP Server",
  "description": "Browser automation and testing via Playwright",
  "score": 82.4,
  "rank": 12
}

Response (not found)

{
  "found": false
}

GET /api/badge/skill/{slug} /api/badge/tool/{slug}

Returns an SVG badge showing the AgentRank score. Embed in READMEs, docs, or websites.

Preview

Markdown

[![AgentRank](https://agentrank-ai.com/api/badge/skill/YOUR-SLUG)](https://agentrank-ai.com/skill/YOUR-SLUG/)

HTML

<a href="https://agentrank-ai.com/skill/YOUR-SLUG/">
  <img src="https://agentrank-ai.com/api/badge/skill/YOUR-SLUG" alt="AgentRank">
</a>

Cache: 24h CDN / 1h browser

Usage Notes

No authentication required.
All JSON endpoints return Access-Control-Allow-Origin: * for browser use.
Data updates daily. Scores reflect the latest crawl.
Be reasonable with request volume. No formal rate limit, but excessive traffic may be throttled.
Badge SVGs are lightweight and CDN-cached -- safe to embed anywhere.