Agentverse Search

Overview

Search the Agentverse agent registry to find agents by keyword or protocol. Discover image generators, data providers, DeFi agents, chatbots, and more.

When to Use

• User asks "find an agent that can..."
• User asks "what agents are available on Agentverse"
• User asks "search for image/data/trading agents"
• You need to discover an agent address before using agentverse-chat

Prerequisites

• AGENTVERSE_API_KEY environment variable set
• Python 3.8+ with requests

Quick Steps

1. Search by keyword

bash
python3 scripts/search_agents.py --query "image generation" --limit 10

2. Search by protocol

bash
python3 scripts/search_agents.py --protocol "proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62"

3. Parse results

json
{
  "status": "success",
  "query": "image generation",
  "semantic": false,
  "total": 42,
  "returned": 5,
  "offset": 0,
  "agents": [
    {
      "name": "Fetch.ai DALL-E 3",
      "address": "agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl",
      "description": "Text-to-image generation using DALL-E 3",
      "domain": "",
      "handle": "",
      "category": "",
      "total_interactions": 62000,
      "recent_interactions": 500,
      "rating": 4.5,
      "success_rate": 0,
      "protocols": ["proto:30a801ed..."],
      "tags": [],
      "status": "active"
    }
  ]
}

How It Works

Uses the Agentverse Search API:

POST https://agentverse.ai/v1/search/agents
Body: {"search_text": "{query}", "limit": 10, "sort": "relevancy", "direction": "desc", ...}

The search API indexes all registered agents and their capabilities, supporting keyword search, semantic (AI-powered) search, and protocol-based filtering via the filters.protocol_digest field.

> Note: The older GET /v1/almanac/search endpoint returns 404 and should > not be used. Use POST /v1/search/agents instead.

Well-Known Agents

| Agent | Address | Capability | |-------|---------|-----------| | Fetch.ai DALL-E 3 | agent1q0utywlfr3dfrfkwk4fjmtdrfew0zh692untdlr877d6ay8ykwpewydmxtl | Text-to-image (DALL-E 3) | | Nano Banana (Image Gen) | agent1qdynamic8lgnax37n20296xr4kcfllahlnse7gy5mrkdt4q9v9h06qkmclkl | Text-to-image |

Edge Cases

• No results: Try broader search terms or check spelling
• Agent offline: online: false means agent may not respond to messages
• Protocol filter: Use the Chat Protocol digest to find all chat-compatible agents:

proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62

References

• Agentverse Almanac
• Agent Chat Protocol