Enable AI coding assistants to interact with OpenSea using the Agent Skill, a modular knowledge and tooling package for AI agents.
What is the Agent Skill?
The OpenSea Agent Skill is an Agent Skill that gives AI coding assistants direct access to the OpenSea API. Once installed, your AI agent can query NFT collections, retrieve metadata, get marketplace listings and offers, execute Seaport trades, and swap ERC20 tokens, all through natural language prompts.
Why use the Agent Skill?
- Purpose-built for coding agents: Designed for Claude Code, Cursor, and Windsurf
- Multiple execution paths: Uses the OpenSea CLI, shell scripts, or the OpenSea MCP server
- Full API coverage: Access all OpenSea REST API endpoints for NFTs, marketplace, tokens, drops, and events
- Built for AI context: Includes TOON output format that uses ~40% fewer tokens than JSON
Quick Start
# Install the skill
npx skills add ProjectOpenSea/opensea-skill
# Get an instant API key (no signup needed)
# Using jq (recommended):
export OPENSEA_API_KEY=$(curl -s -X POST https://api.opensea.io/api/v2/auth/keys | jq -r '.api_key')
# Or without jq, copy the api_key value from the response:
# curl -s -X POST https://api.opensea.io/api/v2/auth/keysThat's it. Your agent can start querying OpenSea immediately. The instant key has free-tier rate limits (60/min read, 5/min write) and expires after 30 days. For higher rate limits, get a full key at Settings -> Developer. Restart your AI tool after installation.
Then prompt your AI assistant with natural language:
- "Get me the floor price for the Pudgy Penguins collection on OpenSea"
- "Show me the best offer on BAYC #1234"
- "Swap 0.02 ETH to USDC on Base using OpenSea"
- "List the 5 most recent sales in the Azuki collection"
- "Search for trending tokens on Base"
Prerequisites
- Node.js >= 18.0.0: required for
@opensea/cli curl: required for shell scriptsjq(recommended): for parsing JSON responses
Documentation
Full documentation including setup guides, operations reference, shell scripts, and configuration is maintained in the GitHub repository:
github.com/ProjectOpenSea/opensea-skill