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 ago| #1 | # OpenSea Skills |
| #2 | |
| #3 | Agent Skills for interacting with [OpenSea](https://opensea.io/): query NFT and token data, trade on the Seaport marketplace, swap ERC20 tokens, and build AI agent tools with onchain gating. |
| #4 | |
| #5 | This repository follows the [Agent Skills specification](https://agentskills.io/specification). |
| #6 | |
| #7 | ## Decision tree |
| #8 | |
| #9 | Pick the right skill in one question: |
| #10 | |
| #11 | ``` |
| #12 | Want to use OpenSea? |
| #13 | ├── Query NFT/token data, search, collection stats ──────── opensea-api |
| #14 | ├── Buy/sell NFTs (listings, offers, fulfillment) ───────── opensea-marketplace |
| #15 | ├── Swap ERC20 tokens (DEX aggregator) ──────────────────── opensea-swaps |
| #16 | ├── Set up wallet signing for transactions ──────────────── opensea-wallet |
| #17 | └── Build/register/gate AI agent tools (ERC-8257) ────── opensea-tool-sdk |
| #18 | ``` |
| #19 | |
| #20 | ## Skills |
| #21 | |
| #22 | ### `opensea-api` |
| #23 | |
| #24 | Query NFT and token data via the OpenSea CLI, MCP server, or shell scripts. Collections, NFTs, tokens, search, drops, events, and account lookups. |
| #25 | |
| #26 | - **Auth**: `OPENSEA_API_KEY` environment variable |
| #27 | - **Setup**: Get a key at [opensea.io/settings/developer](https://opensea.io/settings/developer) or instantly via API |
| #28 | - **Entry point**: [`opensea-api/SKILL.md`](opensea-api/SKILL.md) |
| #29 | |
| #30 | ### `opensea-marketplace` |
| #31 | |
| #32 | Buy and sell NFTs on the Seaport protocol. Create listings and offers, fulfill orders, cross-chain purchases, and sweep multiple listings. |
| #33 | |
| #34 | - **Auth**: `OPENSEA_API_KEY` + wallet provider credentials |
| #35 | - **Entry point**: [`opensea-marketplace/SKILL.md`](opensea-marketplace/SKILL.md) |
| #36 | |
| #37 | ### `opensea-swaps` |
| #38 | |
| #39 | Swap ERC20 tokens across supported chains via OpenSea's DEX aggregator. Get quotes, check balances, and execute swaps. |
| #40 | |
| #41 | - **Auth**: `OPENSEA_API_KEY` + wallet provider credentials (for execution) |
| #42 | - **Entry point**: [`opensea-swaps/SKILL.md`](opensea-swaps/SKILL.md) |
| #43 | |
| #44 | ### `opensea-wallet` |
| #45 | |
| #46 | Set up and configure wallet signing providers for OpenSea transactions. Supports Privy, Turnkey, Fireblocks, Bankr, and local private keys. |
| #47 | |
| #48 | - **Entry point**: [`opensea-wallet/SKILL.md`](opensea-wallet/SKILL.md) |
| #49 | |
| #50 | ### `opensea-tool-sdk` |
| #51 | |
| #52 | Build, 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. |
| #53 | |
| #54 | - **Auth**: Wallet credentials for onchain registration |
| #55 | - **Entry point**: [`opensea-tool-sdk/SKILL.md`](opensea-tool-sdk/SKILL.md) |
| #56 | |
| #57 | ## Less-obvious routing |
| #58 | |
| #59 | The tree above covers the common cases. These edge cases catch the easy-to-misroute ones: |
| #60 | |
| #61 | | Scenario | Skill | |
| #62 | |---|---| |
| #63 | | Browse and mint NFT drops | `opensea-api` | |
| #64 | | Stream real-time marketplace events (WebSocket) | `opensea-api` | |
| #65 | | Cross-chain NFT purchase (pay from a different chain) | `opensea-marketplace` | |
| #66 | | Sweep multiple listings in one transaction | `opensea-marketplace` | |
| #67 | | Check token balances for a wallet | `opensea-swaps` | |
| #68 | | Configure wallet signing policies (caps, allowlists) | `opensea-wallet` | |
| #69 | | Gate a tool with NFT ownership or x402 payments | `opensea-tool-sdk` | |
| #70 | |
| #71 | ## Installation |
| #72 | |
| #73 | All three paths install the router `SKILL.md` plus all five sub-skills: |
| #74 | |
| #75 | ```bash |
| #76 | # Auto-installs all five skills (recommended) |
| #77 | npx skills add ProjectOpenSea/opensea-skill --yes |
| #78 | |
| #79 | # ClawHub (single slug, all skills bundled) |
| #80 | clawhub install opensea |
| #81 | |
| #82 | # Manual (Claude Code / Cursor / Codex) |
| #83 | git clone https://github.com/ProjectOpenSea/opensea-skill.git ~/.claude/skills/opensea |
| #84 | ``` |
| #85 | |
| #86 | After install, the consuming agent reads `SKILL.md` (the router), which directs it to the relevant sub-skill based on the task. |
| #87 | |
| #88 | ## Official Links |
| #89 | |
| #90 | - [Developer docs](https://docs.opensea.io/) |
| #91 | - [OpenSea CLI](https://github.com/ProjectOpenSea/opensea-cli) |
| #92 | - [OpenSea MCP Server](https://mcp.opensea.io) |
| #93 | - [Get an API key](https://opensea.io/settings/developer) |
| #94 | |
| #95 | ## Specification |
| #96 | |
| #97 | These skills follow the [Agent Skills specification](https://agentskills.io/specification). |
| #98 | |
| #99 | ## Publishing (maintainer notes) |
| #100 | |
| #101 | ### Repo layout |
| #102 | |
| #103 | 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. |
| #104 | |
| #105 | ### ClawHub |
| #106 | |
| #107 | Register one slug (`opensea`) and publish via `clawhub skill publish .`. The installed layout: |
| #108 | |
| #109 | ``` |
| #110 | opensea/ |
| #111 | ├── SKILL.md # router; agent registers this |
| #112 | ├── opensea-api/SKILL.md |
| #113 | ├── opensea-marketplace/SKILL.md |
| #114 | ├── opensea-swaps/SKILL.md |
| #115 | ├── opensea-wallet/SKILL.md |
| #116 | └── opensea-tool-sdk/SKILL.md |
| #117 | ``` |
| #118 | |
| #119 | Do **not** publish five separate ClawHub slugs. |
| #120 | |
| #121 | ### `npx skills add` behavior |
| #122 | |
| #123 | The 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. |
| #124 | |
| #125 | ## License |
| #126 | |
| #127 | MIT |
| #128 |