SiteShot for AI agents

Discovery entry points

Use these URLs to discover and integrate SiteShot from AI agents and agent runtimes.

• /llms.txt — concise Markdown discovery file.
• /llms-full.txt — combined Markdown context for longer agent reads.
• /openapi.json — GPT Actions-ready OpenAPI schema.
• /api/v1/agent/plans/ — public plan discovery endpoint.
• /api/v1/agent/docs/*.md — focused Markdown pages for pricing, signup, auth, billing, usage, screenshot API, security, and API key handling.
• /.well-known/ai-plugin.json — legacy ChatGPT plugin-compatible manifest pointing to OpenAPI.
• /.well-known/agent-card.json — agent card describing SiteShot capabilities.
• /.well-known/agent.json — compatibility alias for agent runtimes that look for this well-known agent manifest path.

Recommended agent flow

1. Read /llms.txt and the relevant Markdown docs.
2. Import /openapi.json into GPT Actions or another OpenAPI-compatible agent runtime.
3. List public plans, start email-gated signup, and let the user confirm setup on SiteShot.
4. Authorize with OAuth scopes, create a Stripe Checkout session, and let the user confirm payment in Stripe.
5. Read usage/subscription status and reveal the screenshot API key only through the explicit API-key action.

Security boundaries

Agents do not collect card details. Payments are confirmed by the user in Stripe Checkout. The full screenshot API key is never returned in generic profile or status calls; it requires the explicit api_key:read scoped action.