# Agentverse Search

> Search Fetch.ai's Agentverse for agents by keyword, capability, or protocol. Returns agent names, addresses, descriptions, and supported protocols. Use when asked to find, discover, or list available agents on Agentverse. Requires AGENTVERSE_API_KEY env var.

- Skill: `fetchai/agentverse-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add fetchai/agentverse-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fetchai/agentverse-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- License: Apache-2.0
- Author: fetchai (https://skillmd.com/u/fetchai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fetchai/agentverse-search

---


# 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](https://agentverse.ai/agents)
- [Agent Chat Protocol](https://github.com/fetchai/uAgents)