repositories
loading repo index
repositories
loading repo index
repository
loading code, commits, and activity
Mirrored from https://github.com/ProjectOpenSea/opensea-skill
stars
latest
clone command
git clone gitlawb://did:key:z6MkqRzA...RfoM/ProjectOpenSea-...git clone gitlawb://did:key:z6MkqRzA.../ProjectOpenSea-...fef93001Release v2.14.09h agoAgent Skills for interacting with OpenSea: query NFT and token data, trade on the Seaport marketplace, swap ERC20 tokens, and build AI agent tools with onchain gating.
This repository follows the Agent Skills specification.
Pick the right skill in one question:
Want to use OpenSea? ├── Query NFT/token data, search, collection stats ──────── opensea-api ├── Buy/sell NFTs (listings, offers, fulfillment) ───────── opensea-marketplace ├── Swap ERC20 tokens (DEX aggregator) ──────────────────── opensea-swaps ├── Set up wallet signing for transactions ──────────────── opensea-wallet └── Build/register/gate AI agent tools (ERC-8257) ────── opensea-tool-sdk
opensea-apiQuery NFT and token data via the OpenSea CLI, MCP server, or shell scripts. Collections, NFTs, tokens, search, drops, events, and account lookups.
OPENSEA_API_KEY environment variableopensea-marketplaceBuy and sell NFTs on the Seaport protocol. Create listings and offers, fulfill orders, cross-chain purchases, and sweep multiple listings.
OPENSEA_API_KEY + wallet provider credentialsopensea-swapsSwap ERC20 tokens across supported chains via OpenSea's DEX aggregator. Get quotes, check balances, and execute swaps.
OPENSEA_API_KEY + wallet provider credentials (for execution)opensea-walletSet up and configure wallet signing providers for OpenSea transactions. Supports Privy, Turnkey, Fireblocks, Bankr, and local private keys.
opensea-tool-sdkBuild, register, and gate AI-callable tool endpoints using the OpenSea Tool Registry (ERC-8257) on Base. Supports x402 pay-per-call and NFT-gated access.
The tree above covers the common cases. These edge cases catch the easy-to-misroute ones:
| Scenario | Skill |
|---|---|
| Browse and mint NFT drops | opensea-api |
| Stream real-time marketplace events (WebSocket) | opensea-api |
| Cross-chain NFT purchase (pay from a different chain) | opensea-marketplace |
| Sweep multiple listings in one transaction | opensea-marketplace |
| Check token balances for a wallet | opensea-swaps |
| Configure wallet signing policies (caps, allowlists) | opensea-wallet |
| Gate a tool with NFT ownership or x402 payments | opensea-tool-sdk |
All three paths install the router SKILL.md plus all five sub-skills:
# Auto-installs all five skills (recommended) npx skills add ProjectOpenSea/opensea-skill --yes # ClawHub (single slug, all skills bundled) clawhub install opensea # Manual (Claude Code / Cursor / Codex) git clone https://github.com/ProjectOpenSea/opensea-skill.git ~/.claude/skills/opensea
After install, the consuming agent reads SKILL.md (the router), which directs it to the relevant sub-skill based on the task.
These skills follow the Agent Skills specification.
The root SKILL.md is a thin router that directs agents to the correct sub-skill. This ensures a single install (npx skills add or clawhub install) delivers all five skills with intelligent routing.
Register one slug (opensea) and publish via clawhub skill publish .. The installed layout:
opensea/ ├── SKILL.md # router; agent registers this ├── opensea-api/SKILL.md ├── opensea-marketplace/SKILL.md ├── opensea-swaps/SKILL.md ├── opensea-wallet/SKILL.md └── opensea-tool-sdk/SKILL.md
Do not publish five separate ClawHub slugs.
npx skills add behaviorThe vercel-labs/skills CLI discovers both root SKILL.md and skills/ subdirectories. With the router at root, npx skills add ProjectOpenSea/opensea-skill installs the router plus all sub-skills as a single directory tree. Verify this with --dry-run after any structural changes.
MIT