io.github.vncent786/bounty-api
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
Open source Repository Open in the app JSON README (API)
About
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- vncent786
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.8.0
- Stars
- 1
- Last push
- 2026-08-31T15:31:54Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.vncent786/bounty-api
README
# Bounty **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. Users: 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. Live at [bountyapi.com/dashboard](https://bountyapi.com/dashboard) (token-gated). ## Read this first 1. **`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.** 2. **`STATE.md`** — product philosophy, what's built, gaps, priority order. ## Quickstart ```bash python -m pytest tests/ -x -q # 189+ tests, must be green before every push python -m uvicorn app:app --port 8000 # local dev; BOUNTY_ENV=development bypasses token gate # open http://localhost:8000/dashboard ``` Deploy: push to `main` → Railway auto-builds → bountyapi.com. Nothing else. ## What this repo is NOT - **Not the x402/USDC data-API marketplace** — that code exists but is deferred (see `docs/legacy/`) - **Not Singapore property/real-estate tooling** — legacy, deferred - **Not an MCP directory play** — legacy, deferred Old strategy and marketing documents live in [`docs/legacy/`](docs/legacy/) and describe that earlier direction. They are kept for history only. ## Layout | Path | What | |---|---| | `apis/` | FastAPI routers (dashboard API, dashboard page, social search) | | `public/` | Dashboard frontend (vanilla JS/CSS) | | `social_scraper/` | Connectors, broker, discovery pipeline, monitoring, storage, LLM client | | `tests/` | Full suite | | `docs/legacy/` | Superseded strategy docs — do not implement from these |