# CompetLab Docs

> Guides and reference for CompetLab — monitor your competitive position across the AI answer engines and your market, read your monthly Strategic Briefing, and bring it all into the AI tools you already use or build on it in code.

This file is a convenience index of the CompetLab documentation for coding and IDE agents. It is a map of what exists, not a ranking signal.

## Get started

- [Get started](https://competlab.com/docs/get-started): What CompetLab is, what it tracks across the AI answer engines, and the two ways to put it to work — in your AI tools or in your code.
- [Core concepts](https://competlab.com/docs/get-started/concepts): The building blocks of CompetLab: projects and competitors, the 13 dimensions (5 monitored continuously + 8 researched for the briefing), the AI Visibility Score, and the Strategic Briefing.
- [Methodology](https://competlab.com/docs/get-started/methodology): How CompetLab collects and computes AI-visibility intelligence — the engines we query, how we score, how often we refresh, and, honestly, what we do and do not claim.
- [Quickstart](https://competlab.com/docs/get-started/quickstart): The fastest path from a CompetLab API key to real competitive intelligence — connect an AI assistant, call the REST API, or install the Agent Skills.

## Monitoring

- [Monitoring](https://competlab.com/docs/monitoring): How CompetLab watches your competitive position — the five dimensions it tracks continuously, how a check works, how to set each one's cadence, and how it all feeds your alerts and the briefing.
- [AI Visibility](https://competlab.com/docs/monitoring/ai-visibility): See how ChatGPT, Claude, and Gemini answer when your buyers ask for a recommendation — who they name, who they push, and where you stand against the whole field.
- [Alerts](https://competlab.com/docs/monitoring/alerts): The notification layer between checks — when a new run moves meaningfully against the last, CompetLab raises a plain-language alert, tells you why it matters, and routes it to the channel you actually read.
- [Content](https://competlab.com/docs/monitoring/content): Watch what your rivals publish — every page on their sites, sorted into types like blog posts, docs, landing pages, and case studies — counted, compared to yours, and diffed over time so you see the gaps as they open.
- [Positioning](https://competlab.com/docs/monitoring/positioning): Watch how your rivals describe themselves — the differentiators they claim, who they say they're for, the features they lead with, and how they ask for the click — read from their live sites and diffed against you over time.
- [Pricing](https://competlab.com/docs/monitoring/pricing): Watch your rivals' plans, tiers, and prices read straight from their pricing pages — the trials and free plans they offer, how they package their tiers, and exactly where your price sits in the market.
- [Tech & Trust](https://competlab.com/docs/monitoring/tech-trust): Watch your rivals' security, tech stack, and trust signals — including whether AI crawlers can even reach them, the readiness check that decides whether an AI answer can cite a site at all.

## Briefing

- [Strategic Briefing](https://competlab.com/docs/briefing): CompetLab's monthly Strategic Briefing — the analyzed layer on top of monitoring that reads across all 13 dimensions and tells you what changed, what it means, and what to do next.
- [How it's generated](https://competlab.com/docs/briefing/how-its-generated): How CompetLab compiles a Strategic Briefing edition — the monitored history and fresh research that feed it, the cross-dimension synthesis, and why a light cycle is a normal outcome.
- [Reading a briefing](https://competlab.com/docs/briefing/reading-a-briefing): How to read a Strategic Briefing edition — every section in the order you meet it, from the opening thesis to the one recommended decision, plus the sortable actions backlog.

## Developers

- [Developers](https://competlab.com/docs/developers): Build on CompetLab in code — the REST API, the complete API Reference, and the TypeScript SDK.
- [API Reference](https://competlab.com/docs/developers/api): Complete REST API reference for CompetLab, generated from the live OpenAPI spec — every endpoint with its parameters, an example response, the full field reference, and error codes.
- [REST API](https://competlab.com/docs/developers/rest-api): The CompetLab REST API is a read API over HTTPS at https://api.competlab.com, versioned under /v1 and authenticated with a CL-API-Key header.
- [TypeScript SDK](https://competlab.com/docs/developers/sdk): Work with @competlab/sdk, the official typed TypeScript client for the CompetLab REST API — install it, construct a client from your API key, and reach every resource through methods that map one-to-one to the REST endpoints.
- [AI Visibility](https://competlab.com/docs/developers/api/ai-visibility): AI Visibility endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Alerts](https://competlab.com/docs/developers/api/alerts): Alerts endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Competitors](https://competlab.com/docs/developers/api/competitors): Competitors endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Content](https://competlab.com/docs/developers/api/content): Content endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Health](https://competlab.com/docs/developers/api/health): Health endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Positioning](https://competlab.com/docs/developers/api/positioning): Positioning endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Pricing](https://competlab.com/docs/developers/api/pricing): Pricing endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Projects](https://competlab.com/docs/developers/api/projects): Projects endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Schedules](https://competlab.com/docs/developers/api/schedules): Schedules endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Strategic Briefing](https://competlab.com/docs/developers/api/strategic-briefing): Strategic Briefing endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Tech & Trust](https://competlab.com/docs/developers/api/tech-trust): Tech & Trust endpoints of the CompetLab REST API — request parameters, an example response, the full response field reference, and error codes, generated from the OpenAPI spec.
- [Tools](https://competlab.com/docs/developers/api/tools): The CompetLab free scan tools — sitemap, AI-crawler, URL fetch, and the tech-stack / trust-signals / agent-adoption scans. Run against any public domain, no project needed.
- [Authentication](https://competlab.com/docs/developers/rest-api/authentication): Authenticate to the CompetLab REST API with a CL-API-Key header. Create keys in the dashboard; keys start with cl_live_ and are 40 characters.
- [Quickstart](https://competlab.com/docs/developers/rest-api/quickstart): Make your first authenticated CompetLab REST API request — list your projects, then pull a dimension — in a couple of minutes.
- [Rate limits](https://competlab.com/docs/developers/rest-api/rate-limits): CompetLab REST API rate limits — the free-tool endpoints are limited per API key; core resource endpoints aren't throttled today. Over-limit requests return 429.
- [Quickstart](https://competlab.com/docs/developers/sdk/quickstart): Install @competlab/sdk, construct a client with your API key, and make your first typed CompetLab request in a couple of minutes.
- [SDK Reference](https://competlab.com/docs/developers/sdk/reference): Every method in @competlab/sdk — 34 methods across 12 resources, each with its parameters, return type, and the REST endpoint it maps to.
- [Agent Adoption](https://competlab.com/docs/developers/api/tools/agent-adoption): The CompetLab Agent Adoption tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.
- [AI Crawler Checker](https://competlab.com/docs/developers/api/tools/ai-crawler-checker): The CompetLab AI Crawler Checker tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.
- [Fetch URL](https://competlab.com/docs/developers/api/tools/fetch-url): The CompetLab Fetch URL tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.
- [Sitemap Visualizer](https://competlab.com/docs/developers/api/tools/sitemap-visualizer): The CompetLab Sitemap Visualizer tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.
- [Tech Stack](https://competlab.com/docs/developers/api/tools/tech-stack): The CompetLab Tech Stack tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.
- [Trust Signals](https://competlab.com/docs/developers/api/tools/trust-signals): The CompetLab Trust Signals tool — endpoints, parameters, an example response, and error codes, generated from the OpenAPI spec.

## AI Agents

- [AI Agents](https://competlab.com/docs/ai-agents): Use CompetLab through your AI assistant — connect it to your competitive intelligence with the MCP server, or run prebuilt Agent Skills that turn that data into finished deliverables.
- [MCP Server](https://competlab.com/docs/ai-agents/mcp): The CompetLab MCP Server is a hosted Model Context Protocol server that gives AI agents read access to your competitive intelligence over Streamable HTTP at https://mcp.competlab.com/mcp.
- [Agent Skills](https://competlab.com/docs/ai-agents/skills): CompetLab Agent Skills are 13 prebuilt Claude Code skills (the competlab-ci-skills plugin) that turn your CompetLab data into finished competitive-intelligence deliverables — briefings, dossiers, battlecards, and a one-command CMO report.
- [Connect](https://competlab.com/docs/ai-agents/mcp/connect): Add the CompetLab MCP Server to Claude Code, Cursor, VS Code, Windsurf, Cline, or Claude on the web — with ready-to-paste config and a CompetLab API key.
- [The tools](https://competlab.com/docs/ai-agents/mcp/tools): Complete reference for the CompetLab MCP Server's 33 tools — projects, competitors, the five monitored dimensions, alerts, schedules, the Strategic Briefing, and the free scan tools — with parameters and examples.
- [Skill Reference](https://competlab.com/docs/ai-agents/skills/reference): All 13 CompetLab Agent Skills — what each produces, the data it uses, and the plain-language phrasings that trigger it.
- [Setup](https://competlab.com/docs/ai-agents/skills/setup): Install the CompetLab Agent Skills plugin, connect the CompetLab MCP server, and run your first skill — three install paths, one MCP prerequisite.

## Reference

- [OpenAPI spec](https://api.competlab.com/v1/docs/openapi.json): the machine-readable OpenAPI document the API Reference is generated from