Give coding agents scoped storefront tools.
The @rareprotocol/rare-profile package ships a plain Markdown skill for Claude, Codex, Cursor, and other agents. It teaches agents how to use the rare-profile CLI for profile metadata, links, stores, products, apps, posts, social, messages, analytics, events, and Studio workflows.
Install and log in
Install the storefront CLI globally, then authorize it through the wallet-less device flow. The CLI prints a user code and sends you to /dashboard/cli; after approval, it stores an slk_ token in your local config.
npm install -g @rareprotocol/rare-profile
rare-profile login
rare-profile whoamiThe published package requires Node.js 20+ and can also be installed as a TypeScript SDK with npm install @rareprotocol/rare-profile.
Agent setup
The skill output is regular Markdown, so teams can commit it wherever their agent already reads instructions. Use the same package for Claude skills, Codex AGENTS.md guidance, Cursor rules, or a shared internal agent handbook.
rare-profile skill list
rare-profile skill > .claude/skills/rare-profile-cli/SKILL.md
rare-profile skill >> AGENTS.md
rare-profile skill > .cursor/rules/rare-profile.mdCommand surface
Agent instructions point to the same commands a human can run, which keeps automation auditable and easy to replay from a terminal.
profile, link, storeRead and update profile metadata, link pages, storefront settings, and creator-owned commerce surfaces.
product, app, postAdd, list, edit, unlist, delete, and browse digital products, hosted apps, and posts.
follow, feed, messagesWork with social graph, feeds, followers, following, and creator messaging workflows.
stats, events, studioInspect storefront analytics, event data, and AI Studio workflows for operational updates.
tokens, version, helpAudit token scopes, confirm installed versions, and discover command-level help.
JSON mode for reliable agents
Use --json or RARE_PROFILE_JSON=1 when an agent needs stable output contracts instead of terminal prose.
rare-profile product list --json
RARE_PROFILE_JSON=1 rare-profile stats overview
{"ok":true,"data":{}}
{"ok":false,"error":{"code":"auth_required","message":"Run rare-profile login"}}Exit codes distinguish success, generic or API failure, usage errors, and auth-required states.
Clear guardrails
Wallet-less
rare-profile manages creator content and commerce settings, not private keys or wallet custody.
No buying
Purchase and wallet scopes are blocked for CLI tokens, so agents cannot buy products or move funds.
Token work separated
Minting, NFT deployment, auctions, and marketplace actions live in @rareprotocol/rare-cli.