Skip to content

hillarynjuguna/clearbid

Repository files navigation

ClearBid: Verifiable Intelligence for Opaque Markets

ClearBid is a Commerce Intelligence Node that provides structured, auditable intelligence for navigating opaque algorithmic commerce systems. We transform complex commercial contexts into Intelligence Audits with clear verdicts and exposed reasoning. The first Intelligence Audit is always free—it's our commitment to verifiable testimony.

The Challenge: Opaque Algorithmic Commerce

Today, critical commerce decisions are made in the dark. Whether you're a brand on Instagram Shopping, a seller on Shopee, an advertiser on Google Ads, or a creator managing brand deals, the underlying algorithms are black boxes. You don't know if your listing is optimized, if your ad spend is efficient, or if your deal is market-rate. Expertise is fragmented, and AI systems often lack the discipline to be truly trustworthy.

ClearBid is not a marketplace or an aggregator. It is your Agentic Decision Support System (ADSS), providing a critical verification layer. We apply vertical-specific analytical gates to your commercial context and deliver a Direct Action State: GO, NO-GO, or CONDITIONAL, always with transparent reasoning.

Core Components: Your Intelligence Audit

An Intelligence Audit (formerly DealPacket) is the core deliverable. Each audit provides:

  • Vertical-Specific Analysis: Tailored insights across Social Commerce, Marketplace Selling, Ad Campaigns, Procurement, and the Creator Economy. We evaluate dimensions like listing SEO, operational health, market momentum, competitive positioning, and brand legitimacy.
  • Direct Action Verdict: A clear GO, NO-GO, or CONDITIONAL recommendation for your commercial position.
  • Exposed Reasoning: The complete logic behind our verdict. You see the analysis, not just the conclusion.
  • Evidence Lineage: Transparent sourcing for every claim, distinguishing between Observed (direct API data), Inferred (high-confidence logic), and Speculative (market heuristics).
  • Verifiable Trust Score: A dynamic metric reflecting the density and integrity of the evidence supporting the audit.
  • Actionable Recommendations: Prioritized, non-autonomous next steps to optimize your commercial strategy.

How ClearBid Works: The Verification Layer

ClearBid operates as a Commercial Intent Verifier through two primary modes:

BYOC (Bring Your Own Credentials). Securely connect your Meta, Shopee, or Google Ads accounts. ClearBid pulls live account data via the Model Context Protocol (MCP), generates a data-rich Intelligence Audit, and returns it. Your credentials are never stored beyond the API call lifecycle.

Text-Based Analysis. If no credentials are provided, ClearBid reasons from your text description alone. While live data always produces higher-fidelity audits, the system degrades gracefully, clearly flagging missing data and lowering the Verifiable Trust Score.

The v-Node: Testimony Precedes Payment

The v-Node (ν-node) is ClearBid's economic and trust foundation. It embodies the principle that testimony precedes payment: you experience the value of an Intelligence Audit before committing financially. The first audit is always free, an irreversible act of providing value that initiates the accumulation of trust. Your decision to proceed is based on verifiable evidence, not just a promise.

This is trust built through irreversibility residue—a structural property measured by the degree of verifiable value exchanged.

Deployment & Interoperability

ClearBid is built for the agentic web:

  • Next.js Web Application (Vercel)
  • Supabase Database for Intelligence Audit persistence
  • MCP Server for agent-to-agent communication
  • A2A Agent Card for discovery and interoperability
  • OpenRouter / Claude for intelligence generation

Getting Started

  1. Clone the repository
  2. Install dependencies: npm install
  3. Configure environment variables (see .env.example)
  4. Deploy to Vercel or run locally: npm run dev
  5. Access the web interface at http://localhost:3000

API Endpoints

  • POST /api/intelligence — Generate an Intelligence Audit
  • GET /api/intelligence?packetId=<id> — Retrieve a stored audit
  • GET /.well-known/agent-card — Retrieve the A2A Agent Card

Status

V2.0 architecture complete. Multi-vertical system prompts implemented. BYOC integration adapters built. Supabase persistence layer configured. MCP server and A2A Agent Card exposed. Next.js API routes wired. UI reinvented. Epistemic reliability layer integrated. Ready for deployment.

Author

Hillary Njuguna. Oscillatory Fields. hillary-site.vercel.app

About

ClearBid — procurement intelligence built on the nu-node principle. Testimony precedes payment. DealPackets at USD 50.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors