kensho-kclub

# kensho-kclub — Kenshou Club Sweepstakes MCP Server

Read-only MCP server exposing the kensho Japan X/Twitter sweepstakes dataset from kenshou.club (additional sweepstakes source for Kensho collection).

## Tools

| Tool | Description |
|------|-------------|
| `current_sweep(keyword)` | Latest sweep matching keyword (prize, brand, URL substring) |
| `sweep_history(keyword, limit=50)` | Price time series (oldest first) |
| `top_prize_movers(direction=None, limit=10)` | Biggest |delta JPY| prize value movers, optional up/down filter |

## Data

- Source: `data/accumulated.jsonl` (estimated 100+ observations, snapshot 2026-09-28)
- Source: kenshou.club sweepstakes archives (tagged "twitterで応募", up to 24 pages)
- No network, no API key, no account required

## Run

```bash
python server/server.py          # stdio MCP transport
python server/server.py --http   # streamable-http at /mcp
```

Requires `fastmcp>=3.0.0` (see `requirements.txt`).

## MCP Bundle

`manifest.json` follows the MCPB v0.4 spec. Pack with:

```bash
npx -y @anthropic-ai/mcpb pack . dist/kensho-kclub.mcpb
```

## Revenue Model

This MCP Connector follows the Kensho revenue sharing model:
- 20% to Apify (platform fee)
- PPE model continues for internal operations
- Revenue generated from external queries via Apify MCP integration

## Integration Notes

The kensho-kclub MCP Connector serves as an additional data source for the main Kensho sweepstakes collection, complementing the existing knshow.com, ken-kaku.com, kenshou.club, and cp.meikan.org sources. It provides specialized coverage of the Kenshou.club sweepstakes ecosystem with 24 pages of archives tagged with "twitterで応募".