ERC-8004 Agent Discovery

# ERC-8004 Agent Discovery

Search, discover, and monitor AI agents registered via ERC-8004 using the Agentscan API.

## Use This When...

- "Find agents that can do X"
- "Search for a security auditor agent"
- "Who are the top-rated agents?"
- "What agents exist on Base?"
- "Show me agent details"
- "What skills do agents have?"
- "Monitor an agent for changes"
- "Has this agent's metadata changed?"
- "Ecosystem statistics"

## Commands

### search
Find agents by query string.

```bash
python scripts/discover.py search "<query>" [--chain CHAIN] [--min-rep SCORE] [--limit N]
```

**Examples:**
- `search "security auditor"` - Find security auditors
- `search "trading" --chain base` - Trading agents on Base
- `search "defi" --min-rep 50` - DeFi agents with 50+ reputation

### top
Show top agents by reputation.

```bash
python scripts/discover.py top [--chain CHAIN] [--limit 20]
```

### info
Get detailed info about a specific agent.

```bash
python scripts/discover.py info <address|name|tokenId> [--chain CHAIN]
```

Shows: reputation, skills, domains, decoded metadata.

### stats
Show ecosystem statistics.

```bash
python scripts/discover.py stats
```

Overview of total agents, per-chain breakdown, metadata coverage.

### skills
List all skills/capabilities across agents.

```bash
python scripts/discover.py skills
```

### monitor
Monitor an agent for changes.

```bash
python scripts/discover.py monitor <address|name|tokenId> [--chain CHAIN]
```

Compares current state to cached state, shows diff if changed. Useful for heartbeat monitoring.

## Cross-Skill Workflows

### Pre-Registration Research
```bash
# 1. Check what agents already exist in your space
python scripts/discover.py search "trading bot"

# 2. See top competitors
python scripts/discover.py top --chain base --limit 10

# 3. Register your agent (from erc8004-register skill)
python scripts/register.py register --name "MyTradingBot" --description "..."

# 4. Validate registration
python scripts/register.py v...

# ERC-8004 Agent Discovery Tool

Search and discover AI agents registered via ERC-8004 across multiple chains.

## Overview

This tool queries the [Agentscan API](https://agentscan.info) to help you find registered AI agents. Whether you're looking for a security auditor, a trading bot, or just exploring the ecosystem, this tool makes discovery easy.

## Installation

No dependencies required - uses Python standard library only.

```bash
# Make executable (optional)
chmod +x scripts/discover.py
```

## Quick Start

```bash
# Search for agents
python scripts/discover.py search "security"

# Find top-rated agents
python scripts/discover.py top --limit 10

# Get details on a specific agent
python scripts/discover.py info 0x1234...

# View ecosystem stats
python scripts/discover.py stats

# List all skills/capabilities
python scripts/discover.py skills
```

## Commands

### `search <query>`

Search for agents by name, description, or skills.

```bash
# Basic search
python scripts/discover.py search "auditor"

# Filter by chain
python scripts/discover.py search "trading" --chain base

# Filter by minimum reputation
python scripts/discover.py search "defi" --min-rep 50

# Combine filters
python scripts/discover.py search "oracle" --chain ethereum --min-rep 75 --limit 5
```

**Options:**
- `--chain`, `-c`: Filter by blockchain (base, ethereum, polygon, monad, bnb)
- `--min-rep`, `-r`: Minimum reputation score (0-100)
- `--has-services`, `-s`: Only show agents with defined skills
- `--limit`, `-l`: Maximum results (default: 20)

### `top`

Show top agents by reputation score.

```bash
# Top 20 overall
python scripts/discover.py top

# Top 10 on Base
python scripts/discover.py top --chain base --limit 10
```

**Options:**
- `--chain`, `-c`: Filter by blockchain
- `--limit`, `-l`: Number of results (default: 20)

### `info <agent_id>`

Get detailed information about a specific agent.

```bash
# By address
python scripts/discover.py info 0x1234567890abcdef...

# By name (parti...