{"skill":{"slug":"selva","displayName":"Selva","summary":"Shopping platform for AI agents","description":"---\nname: Selva\ndescription: Shopping platform for AI agents\n---\n\n# Selva\n\nShopping platform for AI agents. Search, compare, and buy physical products from Amazon.\n\n## User Experience\n\n- Be concise and human. Do not narrate command execution unless asked.\n- Prefer outcome-first messaging:\n  - Good: \"You’re registered. I can search now. Want me to find options for `<item>`?\"\n  - Avoid: \"CLI installed... API key saved... next command is...\"\n- Ask for only the missing info needed for the next step.\n- When sharing links, use friendly markdown labels when supported:\n  - `[Open settings page](https://...)`\n- When listing products for chat clients, send each product as a separate message with:\n  - the product image as a photo attachment\n  - a short caption (title, price, rating/reviews, delivery)\n  - a final text message asking which item to open or buy\n\n## Default Conversation Flow\n\n1. **Register quietly**\n   - If registration is needed, do it and confirm briefly.\n2. **Check readiness**\n   - If name or address is missing, ask for them naturally.\n   - If card is missing and user wants to buy, offer the settings link.\n3. **Search and guide**\n   - Present top choices clearly (title, price, rating, delivery/get-it-by, image url, quick reason).\n   - Ask a simple follow-up: \"Want details on any of these?\"\n4. **Buy**\n   - Confirm selected item and payment method.\n   - If approval flow is enabled and triggered, explain next action briefly.\n\n\n## Setup\n\n1. `npx selva-cli register` — generates an API key, stored locally at ~/selva/config.json\n2. `npx selva-cli settings set-name --name \"Jane Doe\"` — required before buying\n3. `npx selva-cli settings set-address --street \"123 Main St\" --line2 \"Apt 4B\" --city \"Austin\" --state \"TX\" --zip \"78701\" --country \"US\"` — required before buying (`--line2` optional)\n4. Optionally set phone: `npx selva-cli settings set-phone --phone \"+14155551234\"`\n5. Optionally set email for purchase receipts and approval notifications: `npx selva-cli settings set-email --email \"you@example.com\"`\n6. Link a payment card and optionally set an approval threshold at the web settings page: `npx selva-cli settings page`\n\n# Commands\n\n### Search\n`npx selva-cli search \"<query>\"`\nReturns up to 10 normalized results with `selva_id`, title, price, rating, source, url, `delivery_estimate` (get-it-by), and `image_url`.\nWhen presenting search results to users, always include delivery/get-it-by text.\nPrefer separate photo messages with captions (one per item) over markdown image links.\nRequires address for best results but works without one.\n\n### Details\n`npx selva-cli details <selva_id>`\nReturns full product details from the original provider. Use the `selva_id` from search results (e.g. `amzn_B0EXAMPLE`).\n\n### Buy\n`npx selva-cli buy <selva_id> --method <saved|card>`\nRequires name, address, and a chargeable card profile. Buy creates an order record and returns its current status.\nIf an approval threshold is configured and the price exceeds it, the order enters `awaiting_approval` and an approval email is sent.\n\nOptions:\n- `--method saved` — uses the card linked on the settings page. Fails if no card is linked - ask the user to link one.\n- `--method card --number <num> --exp <MM/YY> --cvv <code>` — tokenizes with Stripe and saves a reusable payment method snapshot for later processing. Card details never reach the Selva API.\n\n### Orders\n`npx selva-cli orders`\nLists all orders with status: awaiting_approval, processing, expired, shipping.\nStatus meaning:\n- `awaiting_approval`: waiting for user approval email click.\n- `processing`: order accepted and being processed.\n- `shipping`: shipping status has been updated.\n\n### Settings\n- `npx selva-cli settings` — view current name, phone, address, email, approval threshold, and linked card info\n- `npx selva-cli settings page` — generates a 24-hour link to the web settings page where a human can link/remove a payment card and set an approval threshold\n- `npx selva-cli settings set-address --street <street> [--line2 <line2>] --city <city> --state <state> --zip <zip> --country <country>`\n- `npx selva-cli settings set-name --name <name>`\n- `npx selva-cli settings set-email --email <email>`\n- `npx selva-cli settings set-phone --phone <phone>`\n\n## Product ID Format\nIDs are prefixed by provider: `amzn_` for Amazon. Pass these to `details` and `buy`.\n\n\n## Capability Reference\n\n- Register user and store API key locally.\n- Search products.\n- Fetch product details.\n- Buy by `selva_id`.\n- View orders.\n- Manage settings (name, phone, address, email, settings page link).\n\n## Command Reference\n\n- `npx selva-cli register`\n- `npx selva-cli search \"<query>\"`\n- `npx selva-cli details <selva_id>`\n- `npx selva-cli buy <selva_id> --method <saved|card>`\n- `npx selva-cli orders`\n- `npx selva-cli settings`\n- `npx selva-cli settings page`\n- `npx selva-cli settings set-address --street <street> [--line2 <line2>] --city <city> --state <state> --zip <zip> --country <country>`\n- `npx selva-cli settings set-name --name <name>`\n- `npx selva-cli settings set-email --email <email>`\n- `npx selva-cli settings set-phone --phone <phone>`\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":585,"installsAllTime":22,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772678644765,"updatedAt":1778491726627},"latestVersion":{"version":"1.0.0","createdAt":1772678644765,"changelog":"Selva 1.0.0 – Initial release\n\n- Launches a shopping platform for AI agents to search, compare, and buy products from Amazon.\n- Offers concise, human-like messaging for product search, guidance, and purchases.\n- Supports user profile and payment setup, order management, and natural follow-up prompts.\n- Presents search results with images, prices, ratings, delivery details, and easy checkout flow.\n- Provides CLI commands for registering, searching, buying, and managing user/account settings.","license":null},"metadata":null,"owner":{"handle":"jpbonch","userId":"s1715fxz9nqg82afb1gqz9j2pn884sak","displayName":"João Bonchristiano","image":"https://avatars.githubusercontent.com/u/47366914?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089759638}}