# SellOracle

> Real, pre-computed Etsy niche data for AI agents. Blue Ocean scores,
> demand/competition signals, top shops, and seller AI tools — over one
> MCP server or a REST API. Stop letting your agent make up Etsy numbers.

## Connect
- MCP endpoint (Streamable HTTP): https://selloracle.com/mcp
- REST base: https://selloracle.com/api/v1
- Auth: Authorization: Bearer <key>  (free key at https://selloracle.com/dashboard)

## Tools
- get_niche_score [Data, 1cr] — Blue Ocean Score (0–100) for one keyword, with the four underlying signals (demand, saturation, concentration, freshness) plus avg price, views, favorites, and shop count. The computed conclusion — not raw listings.
- get_niche_report [Data, 2cr] — A multi-section deep report for one keyword: verdict, demand & competition read, price band, top shops, and a recommended angle. Everything an agent needs to make a go/no-go call in one call.
- find_blue_ocean [Data, 1cr] — Discover low-competition, high-demand niches in a category, ranked by Blue Ocean Score. Free tier returns the top 5; the full ranked list is the core paid asset.
- search_keywords [Data, 1cr] — Keyword lookup with cached stats (total results, avg price, score). The free hook that gets an agent onto the grid.
- get_best_sellers [Data, 1cr] — Top-selling listings in a category, by favorites/sales signal.
- get_top_shops [Data, 1cr] — Leading shops in a category by sales, with sales/review/follower stats.
- profit_calculator [Data, 1cr] — Full Etsy fee breakdown and net profit for a sale (listing, transaction, payment-processing, and optional offsite-ads fees). Pure math — no data lookup.
- live_keyword_lookup [Live, 2cr] — Real-time Etsy search volume + competition for a keyword (bypasses the cache).
- rank_check [Live, 3cr] — Scan the top 100 results for a keyword and report where a given listing ranks.
- listing_audit [Live, 2cr] — SEO audit of a single live listing (title, tags, attributes).
- shop_analyzer [Live, 2cr] — Real-time deep-dive on a shop's catalog and performance.
- ai_listing_optimizer [AI, 10cr] — Generate an optimized title + 13 tags from the top-ranking listings for a keyword.
- ai_niche_validator [AI, 10cr] — An AI go/no-go verdict on a product idea, grounded in real niche data.
- ai_product_spec [AI, 10cr] — Generate a full product specification for a niche.
- ai_review_insights [AI, 10cr] — Mine a shop's real reviews for what buyers love, complain about, and the concrete fixes.
- ai_reply_writer [AI, 10cr] — Draft a customer-service reply in the seller's voice.
- ai_shop_dashboard [AI, 10cr] — Whole-shop KPIs plus 3–5 specific AI action items for the week.

## Docs
- https://selloracle.com/docs
- https://selloracle.com/tools
- https://selloracle.com/pricing