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.

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.

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

info

Get detailed info about a specific agent.

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

Shows: reputation, skills, domains, decoded metadata.

stats

Show ecosystem statistics.

python scripts/discover.py stats

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

skills

List all skills/capabilities across agents.

python scripts/discover.py skills

monitor

Monitor an agent for changes.

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

# 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 validate 42

Due Diligence Before Interacting

# 1. Get agent details
python scripts/discover.py info 0x1234...

# 2. Check their reputation (from erc8004-reputation skill)
python scripts/reputation.py lookup 42 --chain base

# 3. Decide whether to interact

Competitor Monitoring

# 1. Find competitors
python scripts/discover.py search "security audit"

# 2. Monitor a specific competitor
python scripts/discover.py monitor "CompetitorAgent"

# 3. Check their reputation changes
python scripts/reputation.py lookup 123 --chain base

Heartbeat Integration

Monitor agents for changes in automated pipelines:

# Cron: check if agent changed every 15 minutes
*/15 * * * * python scripts/discover.py monitor 42 >> /var/log/agent-monitor.log 2>&1

# In a monitoring script:
#!/bin/bash
output=$(python scripts/discover.py monitor 42 2>&1)
if echo "$output" | grep -q "CHANGES DETECTED"; then
    echo "Agent 42 metadata changed!" | slack-notify
fi