io.github.vncent786/bounty-api
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'
{
"mcpServers": {
"bounty-api": {
"type": "http",
"url": "https://bountyapi.com/mcp"
}
}
}
bountyapi-mcpclaude mcp add bounty-api -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -- npx -y bountyapi-mcp@1.8.0
{
"mcpServers": {
"bounty-api": {
"command": "npx",
"args": [
"-y",
"bountyapi-mcp@1.8.0"
],
"env": {
"EVM_PRIVATE_KEY": "<your evm_private_key>"
}
}
}
}
Variables d'environnement
EVM_PRIVATE_KEYsecret Optional. EVM private key to enable auto-pay for paid endpoints via x402. Without it, only the 8 free endpoints are callable; paid endpoints return a 402 payment challenge. Never required to use the free tier.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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 (token-gated).
Read this first
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.STATE.md— product philosophy, what's built, gaps, priority order.
Quickstart
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/ 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 |
Questions fréquentes
Qu'est-ce que io.github.vncent786/bounty-api ?
Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.
Comment installer io.github.vncent786/bounty-api ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.vncent786/bounty-api ?
Oui. Il attend EVM_PRIVATE_KEY, à renseigner dans sa configuration.
io.github.vncent786/bounty-api est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient io.github.vncent786/bounty-api ?
Il est publié par vncent786. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.