Skip to content

Devcany/bidradar

Repository files navigation

BidRadar 🎯

Turn any RFQ PDF into a structured bid decision in seconds.

BidRadar is an AI-native B2B API that analyzes Request for Quotation documents and returns structured intelligence — red flags, bid scores, and response skeletons — via a single API call.


What it does

Send a PDF. Get back:

  • Bid Score (0–100) with recommendation: bid / conditional_bid / no_bid
  • Red Flags — timeline risks, liability clauses, payment terms, compliance gaps
  • Requirements — extracted and categorized (technical, legal, logistic, commercial)
  • Response Skeleton — formal opening paragraph in DE or EN

Quick Start

curl -X POST https://your-server:8001/v1/analyze \
  -H "X-API-Key: your-api-key" \
  -F "file=@rfq.pdf"

API Reference

POST /v1/analyze

Parameter Type Description
file PDF RFQ document (max 20MB, text layer required)

Headers: X-API-Key: your-key

Response:

{
  "job_id": "rfq_3f0f2ef1",
  "status": "completed",
  "meta": { "pages": 1, "processing_ms": 17260 },
  "result": {
    "summary": "...",
    "bid_score": 42,
    "bid_recommendation": "conditional_bid",
    "bid_reasoning": "...",
    "red_flags": [...],
    "requirements": [...],
    "response_skeleton": "..."
  }
}

GET /v1/health

Returns {"status": "ok"} — no auth required.


Error Codes

Code Meaning
401 Missing or invalid API key
400 Not a PDF
422 PDF has no text layer (scanned without OCR)
429 Rate limit exceeded (10 requests/day)
500 Internal error

Stack

  • FastAPI — API layer
  • PyMuPDF — PDF text extraction
  • Claude (Anthropic) — AI analysis engine
  • SQLite — Job logging
  • systemd — Production deployment

Scope

BidRadar analyzes private sector RFQs only.
Public procurement and government tenders are out of scope.


Author

Built by Devcany — Industrial AI & B2B API Development.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors