Metadata-Version: 2.4
Name: dromad
Version: 0.2.1
Summary: GEO research tools for coding agents: multi-engine prompt runs, search fanout, question generation, citation analysis and page audits
Keywords: geo,ai-search,citations,llm,cli,agents
Author: John Sillings
Author-email: John Sillings <john@johnsillings.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: typer>=0.12
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.7
Requires-Python: >=3.12
Project-URL: Homepage, https://dromad.dev
Project-URL: Documentation, https://dromad.dev/docs
Project-URL: CLI reference, https://dromad.dev/docs/cli
Project-URL: For agents, https://dromad.dev/docs/agents
Description-Content-Type: text/markdown

# dromad

The Dromad command-line client: GEO research tools built primarily for coding agents.

Dromad asks ChatGPT, Claude and Gemini the questions your customers ask, with each engine's web search on, and records what each one answered and which sources it cited. It counts those citations across runs, generates the questions worth asking, and audits the pages involved. Dromad records evidence and counts it; the reasoning over it is yours or your agent's.

```sh
pip install dromad        # or: uv tool install dromad · pipx install dromad
dromad login              # opens the browser to approve this device
dromad prompt "best search APIs for AI agents"
```

`dromad` talks to the hosted service at [dromad.dev](https://dromad.dev); you need an account there. Access is invite-only for now; signing up sends a request. Every command prints readable output by default and one stable JSON document with `--json`, so an agent can drive it directly. For CI and agents without a browser, set `DROMAD_API_KEY` instead of logging in.

- [Docs](https://dromad.dev/docs): what Dromad records, the quickstart, and what it costs.
- [CLI reference](https://dromad.dev/docs/cli): every command, with real output.
- [For agents](https://dromad.dev/docs/agents): which command when, and how they compose.

This package contains the command, the HTTP client under it, and the pydantic schemas that define the API contract. It depends on typer, httpx and pydantic, and nothing else. Python 3.12 or newer. MIT licensed.
