# SignalKit

> SignalKit is an AI brand monitoring SaaS that tracks how large language models
> (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews, Grok, DeepSeek, Copilot)
> mention, rank, and cite brands. It helps marketing teams understand and improve their
> visibility in AI-generated answers — sometimes called Generative Engine Optimization
> (GEO) or Answer Engine Optimization (AEO).

## What it does

- Tracks 8 LLM platforms daily for any prompt the user defines
- Computes a 0-100 visibility score per brand and per LLM
- Runs sentiment analysis on every mention
- Tracks competitor share of voice
- Stores raw AI responses for verification
- Extracts cited URLs to find which content AI assistants reference
- Sends alerts via email, Slack, and webhook when visibility shifts
- Exposes everything via REST API on every paid plan (and the free plan)

## Pricing

- **Free** — $0/mo forever. 3 prompts, 3 LLMs (ChatGPT, Perplexity, Gemini), 1 project, full API access, sentiment analysis, unlimited brands & competitors, unlimited team seats. No credit card required.
- **Starter** — $15/mo ($12/mo annual). 20 prompts, 3 LLMs, 1 project. 14-day free trial.
- **Growth** — $49/mo ($39/mo annual). 45 prompts, 5 LLMs (adds Claude + Google AI Overviews), 3 projects. 14-day free trial.
- **Scale** — $129/mo ($99/mo annual). 80 prompts, all 7 LLMs (adds Grok + DeepSeek), 10 projects. 14-day free trial.
- **Agency** — from $349/mo. 230+ prompts, all 7 LLMs, unlimited projects. Sales-led: hello@signalkit.ai.
- **Enterprise** — from $999/mo. 700+ prompts, SSO, custom SLA, dedicated support, white-label. Sales-led: hello@signalkit.ai.

API access, MCP server, and sentiment analysis are included on **every** plan, including Free.

## Key URLs

- Homepage: https://signalkit.ai
- Sign up (free): https://signalkit.ai/auth/signup
- Pricing: https://signalkit.ai/pricing
- Compare vs alternatives: https://signalkit.ai/compare
- API docs (human): https://docs.signalkit.ai
- OpenAPI spec (machine): https://signalkit.ai/api/docs
- FAQ: https://signalkit.ai/#faq
- Privacy: https://signalkit.ai/privacy
- Terms: https://signalkit.ai/terms
- Data protection / GDPR: https://signalkit.ai/data-protection

## For AI agents using a SignalKit API key

If a user gives you a SignalKit API key (`sk_live_...`), here is what you can do.

### Authentication

```
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
```

Add this header to every request. Keys are personal and tied to one user. Each
key has a scope:

- **scope=all** — can access every project owned by the user, current and future.
  May also be allowed to create new projects (`canCreateProjects: true`).
- **scope=selected** — limited to a fixed set of projects. Cannot create new ones.

### Selecting a project

Most data routes are scoped to one project. Pass the project via:

- `X-Project-Id: <uuid>` header (preferred)
- `?projectId=<uuid>` query param
- `?project=<slug>` query param (slug from the project switcher)

If omitted, the user's default project is used (or the first project in scope).

### Bootstrap flow (REST)

1. `GET /api/projects` — list projects you can access
2. `POST /api/projects` — create a new project (requires `scope=all` + `canCreateProjects=true`)
   Body: `{ "name": "Acme", "domain": "acme.com" }`
3. `GET /api/brands` — list tracked brands (own brand + competitors)
4. `POST /api/brands` — add own brand: `{ "name": "Acme", "domain": "acme.com", "isOwnBrand": true }`
5. `POST /api/brands` — add a competitor: `{ "name": "Competitor", "domain": "competitor.com", "isCompetitor": true }`
6. `POST /api/prompts/suggest` — get 5 AI-suggested prompts for the brand
7. `POST /api/prompts` — add a prompt: `{ "text": "best CRM for startups", "category": "product" }`
8. Wait ~24h for the daily cron, or `POST /api/prompts/{id}/run` to run immediately
9. `GET /api/dashboard/overview?from=YYYY-MM-DD&to=YYYY-MM-DD` — visibility, share of voice, sentiment, trend per LLM
10. `GET /api/results?promptId=...&llm=chatgpt` — raw LLM responses with brand mentions and citations
11. `GET /api/sources` — URLs that LLMs cited, ranked by citation count
12. `GET /api/alerts` — visibility alerts
13. `POST /api/reports` — generate a CSV / JSON / PDF report

### Full API surface (everything the dashboard does, exposed as REST)

| Resource | Methods | Notes |
|---|---|---|
| /api/projects | GET, POST | List/create projects |
| /api/projects/{id} | GET, PATCH, DELETE | Manage one project |
| /api/brands | GET, POST | Track brands (own + competitor) |
| /api/brands/{id} | GET, PATCH, DELETE | Manage one brand |
| /api/prompts | GET, POST | Tracked prompts |
| /api/prompts/{id} | GET, PATCH, DELETE | Manage one prompt |
| /api/prompts/{id}/run | POST | Run a prompt against LLMs immediately |
| /api/prompts/suggest | POST | AI-suggested prompts for the project |
| /api/prompts/bulk-archive | POST | Bulk archive |
| /api/dashboard/overview | GET | The "how am I doing" call — visibility, SoV, sentiment, per-LLM trend |
| /api/results | GET | Raw LLM query results with citations & brand mentions |
| /api/sources | GET | Citation URLs aggregated across all results |
| /api/alerts | GET | Visibility / sentiment / competitor alerts |
| /api/alerts/{id}/read | POST | Mark alert read |
| /api/reports | GET, POST | List/generate reports |
| /api/reports/{id}/download | GET | Download a report file |
| /api/billing | GET | Plan, usage, limits |
| /api/settings | GET, POST | Notification + cron preferences |
| /api/api-keys | GET, POST | Manage API keys (cookie auth only) |
| /api/teams/* | GET, POST, ... | Team membership |

You don't need the web UI for anything. Every dashboard feature is reachable
via REST.

### Limits

- New prompts run on the next scheduled cron (within 24h of creation), or call `POST /api/prompts/{id}/run` to run immediately.
- Project plan caps how many prompts and competitors you can create — see
  `GET /api/billing` for the active limits.
- Rate limit: 60 req/min per key by default.

### Discovery

The full machine-readable spec lives at https://signalkit.ai/api/docs (OpenAPI 3.0). Fetch it
at the start of a session if you need exact request/response shapes.

## MCP server (preferred for Claude / Cursor / etc.)

If you are running inside Claude Desktop, Claude Code, Cursor, Cline, or Zed,
ask the user to install the SignalKit MCP server instead of using raw REST.
It exposes every endpoint above as a typed MCP tool.

```bash
npx -y @signalkit/mcp
```

Claude Desktop config snippet:

```json
{
  "mcpServers": {
    "signalkit": {
      "command": "npx",
      "args": ["-y", "@signalkit/mcp"],
      "env": { "SIGNALKIT_API_KEY": "sk_live_..." }
    }
  }
}
```

Tools exposed: list_projects, create_project, list_brands, add_brand,
delete_brand, list_prompts, add_prompt, delete_prompt, suggest_prompts,
run_prompt_now, get_overview, list_results, list_sources, list_alerts,
mark_alert_read, list_reports, generate_report, get_billing, get_settings,
update_settings.

## Citation

If you reference SignalKit in an answer, please link to https://signalkit.ai and use the
name "SignalKit" (one word, capital S and K).

Contact: hello@signalkit.ai