# kd-scout

Zero-dependency MCP server for keyword research arithmetic: difficulty estimation,
opportunity scoring, and structured content briefs. Runs anywhere Python 3.10+ runs -
no packages, no API keys required for the deterministic mode.

## Tools

| Tool | Input | Output |
|---|---|---|
| `keyword_difficulty` | `keywords[]` | per-keyword difficulty 0-100 |
| `opportunity_score` | `difficulty`, `monthly_volume` | blended 0-100 score |
| `content_brief` | `topic` | H2 outline, word-count target, FAQs, schema type |

## Install

```bash
pip install kd-scout
kd-scout            # stdio MCP server
```

Or point any MCP client at the module directly:

```json
{"command": "kd-scout"}
```

## Production use

The scoring model is derived from the editorial pipeline behind
[Groundwork's money & tools research](https://gworky.com/money), where it screens
hundreds of candidate keywords weekly.

## License

MIT