English Français العربية

io.github.Kevinx702/agentcite

السجل الرسمي الذكاء الاصطناعي والوكلاء

Fabrication-free, DOI-backed citations for AI agents — real openAlex sources, never hallucinated.

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

التثبيت

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

NPM package agentcite-mcp
Claude Code 
claude mcp add agentcite -- npx -y agentcite-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agentcite": {
            "command": "npx",
            "args": [
                "-y",
                "agentcite-mcp@0.1.1"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. AgentCite
  2. API (MVP)
  3. Roadmap (build order)
  4. Guardrails
  5. Billing (Stripe)

AgentCite

Fabrication-free, DOI-backed citations for AI content & agents. Every result is a real openAlex record (CC0 public-domain data) with a resolvable DOI — the API never fabricates a source. Built to stop the hallucinated-citation problem that gets content E-E-A-T-demoted.

Separate deployable from giftedpicks.com (own Vercel project). Productizes the logic of GiftedPicks/scripts/citation_magnet.py.

API (MVP)

  • GET /api/cite?topic=<q>&n=5&since=YYYY → { topic, count, works[], markdown, source }
    • each work: { title, authors[], first_author, year, doi, doi_url, cited_by_count, venue, openalex_id }
  • GET /api/health → { status, openalex, ts }

Data: openAlex REST (relevance-ranked, peer-reviewed type:article). Set OPENALEX_MAILTO env to join openAlex's polite pool. Edge-cached 1h per topic.

Roadmap (build order)

  1. ✅ Core /cite + /health (openAlex REST, no key, no binary — serverless-portable)
  2. ⏳ API-key + quota gate (Supabase: anon free tier rate-limited vs keyed Pro)
  3. ⏳ MCP server: get_citations(topic, n, since) (stdio + http) — the agent-native surface
  4. ⏳ Stripe billing (TEST mode first; hosted Checkout/Payment Link → webhook provisions quota). GATED: needs .claude/secrets/stripe-test-{publishable,secret}-key saved by Kevin. LIVE go-live = Kevin places the live secret key in the deploy env; agents never hold it.
  5. Landing page + MCP-registry listings — owned by Cowork.

Guardrails

Public-domain data only (zero scraping / no unofficial-site APIs). Honesty is the product: output always says "verify each DOI resolves." Test-mode payments only until Kevin flips live; agents never move money or hold the live key.

Billing (Stripe)

Pro tier via hosted Stripe Checkout (subscription). On checkout.session.completed, the signature-verified webhook (/api/stripe-webhook) provisions a Pro API key in Redis (free→Pro quota elevation). Configure via env:

  • STRIPE_SECRET_KEY, STRIPE_PRICE_ID, STRIPE_WEBHOOK_SECRET, REDIS_URL
  • Create the Pro product/price once: STRIPE_SECRET_KEY=sk_test_… node scripts/setup-stripe-product.js
  • Without Stripe env set, /api/checkout returns 503 and the citation API still runs free-tier.

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

ما هو io.github.Kevinx702/agentcite؟

Fabrication-free, DOI-backed citations for AI agents — real openAlex sources, never hallucinated.

كيف أثبّت io.github.Kevinx702/agentcite؟

يعمل على جهازك. في Claude Code: claude mcp add agentcite -- npx -y agentcite-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Kevinx702/agentcite إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.Kevinx702/agentcite مفتوح المصدر؟

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

من يصون io.github.Kevinx702/agentcite؟

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

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