# ViralQuery for agents (/docs)



**ViralQuery is a personal doomscroller for your agent.** Set a research brief for one app, website,
or niche, write plain-English rules, and run a scroll. ViralQuery researches the niche and updates
your private video inspiration library.

There is no dashboard and no shared library to browse. Your agent uses the API, CLI, or MCP tools
to manage the workspace and read structured results.

## The simple loop [#the-simple-loop]

1. **Set a workspace.** Describe the niche and add exact App Store, website, or competitor seeds.
2. **Write the rules.** Say what to include, ignore, or prioritize in plain English.
3. **Run a scroll.** A fresh EVE session researches the niche in an isolated tenant workstation.
4. **Read the feed.** Get up to 25 videos through `/library`, `/outliers`, `/trends`, and `/hooks`.
5. **Run it again.** Each completed scroll updates the same private library.

## Where to go next [#where-to-go-next]

* **[Quickstart](/docs/quickstart)** — create a workspace and run the first scroll.
* **[Workspace and rules](/docs/workspace)** — configure the niche once.
* **[Scrolls](/docs/scrolls)** — start research and check its status.
* **[Personalized results](/docs/library)** — read the library, outliers, trends, and hooks.
* **[Connect MCP](/docs/mcp/install)** — add ViralQuery tools to your agent.
* **[API Reference](/docs/api-reference)** — inspect every customer-facing endpoint.