platform-onboarding

---
name: platform-onboarding
description: >
license: MIT
---

# Platform Onboarding

## Account

1. Sign up at [promptwatch.com](https://promptwatch.com/).
2. Create an organization if one does not exist.
3. Generate an API key at https://app.promptwatch.com -> Settings -> API Keys.

## Create a Project

Each project tracks one brand or product:

1. Go to Projects -> New Project.
2. Enter the brand name exactly as it should appear in AI responses.
3. Set the primary domain.
4. Choose the product category.

## Add Tracked Prompts

Prompts are the questions you want to monitor across AI engines.

Start with 10-20 prompts covering:

- Category discovery: "best [category] for [audience]".
- Comparison: "[brand] vs [competitor]", "alternatives to [competitor]".
- Use case: "how to [solve problem brand addresses]".
- Brand-specific: "is [brand] good for [use case]".

Add prompts at Projects -> Prompts -> Add Prompt. Use `prompt-discovery` for data-driven expansion later.

## Configure Competitors

Add 3-5 direct competitors:

1. Go to Projects -> Competitors.
2. Add each competitor by brand name.
3. Promptwatch tracks their visibility, mentions, and citations alongside yours.

## Enable Crawler Tracking

Crawler tracking shows which AI bots visit your site:

1. Go to Projects -> Settings -> Crawler Tracking.
2. Add your domain and verify ownership.
3. Ensure `robots.txt` allows AI crawlers (see `geo-technical-setup`).

## Enable Visitor Tracking

Visitor tracking measures AI-referred traffic to your site:

1. Go to Projects -> Settings -> Visitor Tracking.
2. Install the tracking snippet or connect via your analytics platform.
3. Verify by checking for incoming data within 24 hours.

## Verify Data Flow

After setup, confirm each data source is active:

- **Prompts**: Projects -> Prompts shows response data within 24-48 hours.
- **Competitors**: Projects -> Competitors shows visibility scores.
- **Crawlers**: Projects -> Crawlers shows bot activity.
- **Visitors**: Projects -> Visitors shows referred traffic.

If a section shows no data after 48 hours, check project settings, domain verification, and tracking installation.

## Connect MCP

For agent access to Promptwatch data, run `setup-promptwatch-mcp`.

## Next Steps

- Run `visibility-audit` for a baseline health check.
- Run `content-gap-audit` to find missing content.
- Run `competitor-benchmark` to see where you stand.