English Français العربية

io.github.vncent786/bounty-api

السجل الرسمي التجارة الإلكترونية

Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bounty-api": {
            "type": "http",
            "url": "https://bountyapi.com/mcp"
        }
    }
}
NPM package bountyapi-mcp
Claude Code 
claude mcp add bounty-api -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -- npx -y bountyapi-mcp@1.8.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "bounty-api": {
            "command": "npx",
            "args": [
                "-y",
                "bountyapi-mcp@1.8.0"
            ],
            "env": {
                "EVM_PRIVATE_KEY": "<your evm_private_key>"
            }
        }
    }
}

متغيرات البيئة

  • EVM_PRIVATE_KEY سري 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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Bounty
  2. Read this first
  3. Quickstart
  4. What this repo is NOT
  5. Layout

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

  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

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

PathWhat
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

الأسئلة الشائعة

ما هو io.github.vncent786/bounty-api؟

Singapore property & financial data APIs for AI agents. 27 MCP tools. x402 micropayments.

كيف أثبّت io.github.vncent786/bounty-api؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http bounty-api 'https://bountyapi.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.vncent786/bounty-api إلى مفتاح API؟

نعم. يتطلب EVM_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.vncent786/bounty-api مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.vncent786/bounty-api؟

ينشره vncent786. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.