# Shelfforce

> Turn your shelf photos into retail reports with AI Agents. Send our AI agent photos by email or WhatsApp and get reports back in minutes. No platform to learn. No seats to pay for.

## What Shelfforce Does

Shelfforce uses computer vision AI to analyze retail shelf images. Upload or send shelf photos and get:

- **Product Detection**: Identifies every SKU on the shelf — brand, product name, size, variant
- **Facing Counts**: Counts how many facings each product has (share of shelf)
- **Price Extraction**: Reads price tags and matches them to the correct products
- **Compliance Scoring**: Checks shelves against planogram standards and merchandising guidelines
- **Automated Reports**: Generates PDF, CSV, and PowerPoint reports from shelf data

## How It Works

1. Field teams take shelf photos using the mobile app, email, or WhatsApp
2. AI agents analyze the images — detecting products, counting facings, reading prices
3. Reports are generated automatically and sent back to the team
4. Dashboards show real-time shelf intelligence across all locations

## Pricing

All plans include every feature. Pricing is based on credits. 1 credit = 1 image analysis ($0.10/credit). An audit is 1 completed task at a store (up to 20 images = 20 credits).

- **Free**: $0/month — 5 audits (100 credits)
- **Starter**: $49/month — 30 audits (600 credits) — annual: $44.92/month ($539/yr)
- **Growth**: $149/month — 100 audits (2,000 credits) — annual: $136.58/month ($1,639/yr)
- **Pro**: $499/month — 400 audits (8,000 credits) — annual: $457.42/month ($5,489/yr)
- **Scale**: $899/month — 1,000 audits (20,000 credits) — annual: $824.08/month ($9,889/yr)
- **Enterprise**: Custom pricing for larger volumes

Read and write API endpoints are free. You only pay credits for image analysis.

## Features Included in Every Plan

- AI shelf image analysis
- SKU and product detection
- Facing count and share of shelf
- Price tag extraction and attribution
- Planogram compliance scoring
- AI research agent (chat with your shelf data)
- Task and field team management
- Real-time dashboards and reporting
- PDF, CSV, and PowerPoint exports
- Email and WhatsApp image ingestion
- Web, iOS, and Android apps
- Unlimited users
- REST API access

## API

Base URL: `https://api.shelfforce.ai/v1`
Docs: https://docs.shelfforce.ai
Auth: Bearer token with API key (`sf_live_...` or `sf_test_...`)

### Endpoints

**Analyses**
- `POST /analyses` — Submit a shelf image for analysis (1 credit per image)
- `GET /analyses/:id` — Get analysis results (products, facings, prices)
- `GET /analyses` — List analyses with filtering and pagination

**Products**
- `GET /products` — List detected products across analyses
- `GET /products/:id` — Get product details

**Tasks**
- `POST /tasks` — Create an audit task
- `GET /tasks` — List tasks with status filtering
- `GET /tasks/:id` — Get task details and results
- `PATCH /tasks/:id` — Update a task

**Stores**
- `POST /stores` — Create a store
- `GET /stores` — List stores
- `GET /stores/:id` — Get store details
- `PATCH /stores/:id` — Update a store

**Reports**
- `GET /reports/share-of-shelf` — Share of shelf by brand/category
- `GET /reports/compliance` — Compliance scores across stores
- `GET /reports/store-performance` — Store-level performance metrics

**Standards**
- `POST /standards` — Create a compliance standard
- `GET /standards` — List standards
- `PATCH /standards/:id` — Update a standard

**Webhooks**
- `POST /webhooks` — Register a webhook endpoint
- `GET /webhooks` — List registered webhooks
- `DELETE /webhooks/:id` — Remove a webhook

## MCP (Model Context Protocol)

Shelfforce provides an MCP server for AI coding assistants. Connect it to Claude, Cursor, or VS Code to search API docs and get contextual help.

- MCP endpoint: `https://docs.shelfforce.ai/mcp`
- Capabilities: Documentation search, API reference lookup, endpoint discovery

## Integrations

- Salesforce, HubSpot, Shopify, QuickBooks, Xero
- REST API for custom integrations
- Email and WhatsApp ingestion (send photos, get reports)

## Use Cases

- **CPG Brands**: Monitor shelf presence, share of shelf, competitor positioning, and promotion compliance across retail partners
- **Retailers**: Ensure planogram compliance, optimize shelf layouts, and track category performance
- **Field Teams**: Mobile-first task management for in-store audits — no platform to learn
- **Distributors**: Verify product placement and pricing at point of sale

## Pages

- [Home](https://shelfforce.ai): Main landing page
- [Pricing](https://shelfforce.ai/pricing): Detailed pricing and plan comparison
- [Developers](https://shelfforce.ai/developers): API overview and integration guides
- [API Docs](https://docs.shelfforce.ai): Full API documentation
- [MCP Server](https://docs.shelfforce.ai/mcp): MCP endpoint for AI coding assistants
- [Resources](https://shelfforce.ai/resources): Product guides, articles, and updates
- [Privacy Policy](https://shelfforce.ai/privacy): Privacy practices
- [Terms of Service](https://shelfforce.ai/terms): Terms and conditions

## Contact

- Email: hey@shelfforce.ai
- Website: https://shelfforce.ai