{
  "markdown": "# Bounty\n\n**A research system that turns online conversations into cited findings.** Bounty collects posts, comments, and replies from YouTube, Reddit, TikTok, Instagram, and X; discovers rising topics via Google Trends; and uses LLM analysis to extract signals — pain points, adoption patterns, objections, belief shifts — each backed by quotes and source links. If evidence is thin, it says so.\n\nUsers: investors (unknown-unknown discovery, pain-point research around companies), marketers (creative angles, competitor mentions), product teams (feature gaps, user complaints). The engine is horizontal; investing is the first lens, not a hardwired filter.\n\nLive at [bountyapi.com/dashboard](https://bountyapi.com/dashboard) (token-gated).\n\n## Read this first\n\n1. **`AGENTS.md`** — operating manual: architecture, the two-pipeline warning, commands, deploy flow, credentials map, hard rules, known-broken list. **Any agent (or human) working in this repo must read this before making changes.**\n2. **`STATE.md`** — product philosophy, what's built, gaps, priority order.\n\n## Quickstart\n\n```bash\npython -m pytest tests/ -x -q          # 189+ tests, must be green before every push\npython -m uvicorn app:app --port 8000  # local dev; BOUNTY_ENV=development bypasses token gate\n# open http://localhost:8000/dashboard\n```\n\nDeploy: push to `main` → Railway auto-builds → bountyapi.com. Nothing else.\n\n## What this repo is NOT\n\n- **Not the x402/USDC data-API marketplace** — that code exists but is deferred (see `docs/legacy/`)\n- **Not Singapore property/real-estate tooling** — legacy, deferred\n- **Not an MCP directory play** — legacy, deferred\n\nOld strategy and marketing documents live in [`docs/legacy/`](docs/legacy/) and describe that earlier direction. They are kept for history only.\n\n## Layout\n\n| Path | What |\n|---|---|\n| `apis/` | FastAPI routers (dashboard API, dashboard page, social search) |\n| `public/` | Dashboard frontend (vanilla JS/CSS) |\n| `social_scraper/` | Connectors, broker, discovery pipeline, monitoring, storage, LLM client |\n| `tests/` | Full suite |\n| `docs/legacy/` | Superseded strategy docs — do not implement from these |\n",
  "bytes": 2154,
  "sha": "7cd8580774050de26334bc3049a07a3dbce14b03c3463321e5d6e46da1c23ebb",
  "repo_slug": "vncent786/bounty-api",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_vncent786_bounty_api_289cf5c2/readme"
}