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
Comprehensive API coverage — Access all OpenSea REST API endpoints for NFTs, marketplace, tokens, drops, and events
Optimized 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/keys

That'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 scripts
jq (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

Links