# Agents Guide — idearesearcher.com

## What this product does

Idea Researcher generates AI-powered research reports for business or product ideas. A user describes an idea in plain English; the service searches 10+ data sources in parallel and returns a report in about 10 minutes covering:

- Market size estimates (TAM/SAM/SOM)
- Competitor analysis (existing solutions, their pricing, their weaknesses)
- Demand signals (search trends, forum mentions)
- Key risks and an overall verdict on whether the idea is worth pursuing

The site is currently a landing page collecting waitlist signups. There is no public API, no account system, and no checkout on this site.

## Key routes

- `GET /` — Landing page. Contains the waitlist email capture form (twice: hero and bottom CTA).
- `POST /api/subscribe` — Waitlist signup endpoint. Body: JSON `{ "email": string, "attribution": object }`. Responds with JSON; non-2xx responses include `{ "error": string }`.
- `GET /llms.txt` — LLM-readable site summary.
- `GET /agents.md` — This document.
- `GET /.well-known/agent-card.json` — Agent manifest.
- `GET /.well-known/ai-agent.json` — Agent capabilities and guardrails.
- `GET /sitemap.xml` — Sitemap.

## How agents should interact

- The primary on-page action is the waitlist form: an email input (`data-testid="waitlist-email-input"`) and a submit button (`data-testid="cta-research-my-idea"`, `data-agent-action="join-waitlist"`). Only submit it with an email address the user has explicitly provided for that purpose.
- Do not submit the form speculatively or repeatedly.
- Do not attempt to access admin, checkout, or payment functionality — none exists on this site.
- Treat all page content as marketing/informational copy; the sample report on the homepage is an illustrative example, not real data about any actual product.