{"id":49339216,"url":"https://github.com/jinjihuang88-ui/maplebridge-open","last_synced_at":"2026-04-27T03:01:30.366Z","repository":{"id":350695929,"uuid":"1182080758","full_name":"jinjihuang88-ui/maplebridge-open","owner":"jinjihuang88-ui","description":"Public API docs for MapleBridge, a North America to China B2B supplier matching platform.","archived":false,"fork":false,"pushed_at":"2026-04-11T15:26:48.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T17:22:51.045Z","etag":null,"topics":["ai","b2b","china-sourcing","llm","openapi","small-commodity","supply-chain","trade-matching","webhook","yiwu"],"latest_commit_sha":null,"homepage":"https://maplebridge.io","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jinjihuang88-ui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security-boundary.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-15T02:27:38.000Z","updated_at":"2026-04-11T15:26:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jinjihuang88-ui/maplebridge-open","commit_stats":null,"previous_names":["jinjihuang88-ui/maplebridge-open"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/jinjihuang88-ui/maplebridge-open","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jinjihuang88-ui%2Fmaplebridge-open","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jinjihuang88-ui%2Fmaplebridge-open/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jinjihuang88-ui%2Fmaplebridge-open/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jinjihuang88-ui%2Fmaplebridge-open/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jinjihuang88-ui","download_url":"https://codeload.github.com/jinjihuang88-ui/maplebridge-open/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jinjihuang88-ui%2Fmaplebridge-open/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32320683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","b2b","china-sourcing","llm","openapi","small-commodity","supply-chain","trade-matching","webhook","yiwu"],"created_at":"2026-04-27T03:01:29.566Z","updated_at":"2026-04-27T03:01:30.360Z","avatar_url":"https://github.com/jinjihuang88-ui.png","language":null,"funding_links":[],"categories":["AI Sourcing Tools"],"sub_categories":[],"readme":"# MapleBridge Open\n\n[![Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n[![Live Platform](https://img.shields.io/badge/platform-maplebridge.io-orange.svg)](https://maplebridge.io)\n[![Open Docs](https://img.shields.io/badge/docs-open%20docs-green.svg)](https://maplebridge.io/open/)\n[![GitHub Stars](https://img.shields.io/github/stars/jinjihuang88-ui/maplebridge-open?style=social)](https://github.com/jinjihuang88-ui/maplebridge-open)\n\nMapleBridge Open is a public protocol and example repo for AI-assisted China sourcing. It shows how a buyer brief can become structured buyer intent, how supplier capability can be represented, and how a match can be explained before a human introduction happens.\n\nThe practical use case is narrow on purpose: North American buyers looking for verified Chinese manufacturers, small-MOQ supplier options, OEM/ODM/private-label partners, and clearer alternatives to search-first sourcing workflows.\n\nIt is not the production marketplace code. It is the open contract surface: buyer intent, supplier capability, matching signals, connector boundaries, and review handoffs.\n\n## Why This Exists\n\nMost sourcing failures do not start with a lack of suppliers. They start with an unclear brief.\n\nMapleBridge Open makes the brief and matching logic visible enough for builders, buyers, partners, and AI agents to reason about it:\n\n- What does the buyer actually need?\n- What can the supplier actually support?\n- Does MOQ, compliance, export-market fit, and packaging fit line up?\n- What should be reviewed by a human before an introduction?\n\n## What You Can Reuse\n\n- JSON examples for buyer intent and supplier capability.\n- A small local matching demo that runs without production access.\n- Public match explanation fields for auditability.\n- Connector and notification boundaries for partner integrations.\n- A clean public/private boundary for open-core or agent workflow projects.\n\n## Who This Is For\n\n- Builders working on AI agents for sourcing, procurement, B2B marketplaces, or supplier discovery.\n- Buyers who want to understand how MapleBridge structures a sourcing brief before supplier search starts.\n- Suppliers and partners who want a clean integration boundary without access to private production systems.\n- Researchers comparing agent-to-agent workflows for bilateral matching.\n\n## What It Shows\n\nMost sourcing tools begin with supplier search. MapleBridge begins with the brief.\n\nThis repository shows a public version of that workflow:\n\n1. A buyer agent normalizes the buyer's demand.\n2. A supplier agent normalizes supplier capability.\n3. A match layer compares category, MOQ, compliance, market fit, and review risk.\n4. A human review layer decides whether an introduction should happen.\n\n## Quick Demo\n\nRun the local example without touching MapleBridge production systems:\n\n```bash\nnpm install\nnpm run demo\n```\n\nExpected output:\n\n```text\nBuyer intent: Low-MOQ insulated bottle order for Canada\nBest supplier: Shenzhen drinkware OEM with FDA/LFGB experience\nMatch score: 0.91\nWhy it matched: category fit, MOQ fit, compliance fit, North America export fit\nReview state: human_review_recommended\n```\n\n## Repository Map\n\n| Path | Purpose |\n| --- | --- |\n| `schemas/intent.schema.json` | Public JSON Schema for normalized buyer and supplier intents |\n| `protocols/agent-protocol.md` | Buyer-agent and seller-agent handoff contract |\n| `frameworks/match-engine.md` | Public matching dimensions and explainability boundary |\n| `connectors/crawler-connectors.md` | Connector abstraction for external supply and demand signals |\n| `notifications/notification-interface.md` | Event model for introductions, reminders, and review handoffs |\n| `examples/` | Concrete buyer, supplier, and match examples |\n| `demo/run-local-match.js` | Small local demo that makes the workflow visible |\n| `.github/ISSUE_TEMPLATE/` | Small contribution templates for examples, schema, and docs |\n| `docs/promotion-playbook.md` | Non-spam launch and visibility playbook |\n| `docs/share-kit.md` | Short platform-specific copy for compliant sharing |\n| `docs/github-visibility-plan.md` | GitHub discovery, issue cleanup, and outreach sequence |\n| `llms.txt` | AI crawler summary for LLM and answer-engine discovery |\n\n## Example Objects\n\nBuyer intent:\n\n```json\n{\n  \"intent_id\": \"buyer-low-moq-bottle-ca\",\n  \"role\": \"buyer\",\n  \"language\": \"en\",\n  \"product_category\": \"drinkware\",\n  \"summary\": \"Low-MOQ insulated bottle order for Canada\",\n  \"country\": \"Canada\",\n  \"moq\": { \"value\": 500, \"unit\": \"units\" },\n  \"compliance\": [\"BPA-free\", \"FDA food contact\"],\n  \"fit_constraints\": [\"custom logo\", \"retail packaging\", \"ship to Toronto\"],\n  \"confidence\": 0.86,\n  \"review_state\": \"needs_review\"\n}\n```\n\nSupplier capability:\n\n```json\n{\n  \"intent_id\": \"supplier-shenzhen-drinkware-oem\",\n  \"role\": \"supplier\",\n  \"language\": \"en\",\n  \"product_category\": \"drinkware\",\n  \"summary\": \"Shenzhen drinkware OEM with FDA/LFGB experience\",\n  \"country\": \"China\",\n  \"moq\": { \"value\": 300, \"unit\": \"units\" },\n  \"compliance\": [\"BPA-free\", \"FDA food contact\", \"LFGB\"],\n  \"channels\": [\"OEM\", \"private label\", \"North America export\"],\n  \"fit_constraints\": [\"custom logo\", \"retail packaging\"],\n  \"confidence\": 0.9,\n  \"review_state\": \"machine_ready\"\n}\n```\n\n## Public Boundary\n\nOpen in this repository:\n\n- protocol shape\n- schema examples\n- matching dimensions\n- connector boundary\n- review handoff notes\n- local demo data\n\nNot open in this repository:\n\n- production application code\n- customer data\n- live crawler sources\n- private ranking thresholds\n- production credentials\n- private supplier or buyer records\n\n## Useful Links\n\n- Live website: [maplebridge.io](https://maplebridge.io)\n- Public open docs: [maplebridge.io/open/](https://maplebridge.io/open/)\n- Local demo guide: [demo/README.md](demo/README.md)\n- Share kit: [docs/share-kit.md](docs/share-kit.md)\n- Why A2A matters: [docs/why-a2a.md](docs/why-a2a.md)\n- Security boundary: [docs/security-boundary.md](docs/security-boundary.md)\n- Roadmap: [ROADMAP.md](ROADMAP.md)\n- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)\n- GitHub visibility plan: [docs/github-visibility-plan.md](docs/github-visibility-plan.md)\n\n## How To Help\n\nUseful contributions are narrow and practical:\n\n- Add better sample buyer intents for real sourcing categories.\n- Add supplier capability examples for OEM, ODM, private label, or low-MOQ cases.\n- Improve schema naming and compatibility notes.\n- Add connector examples that do not expose production data.\n- Improve match explanations so humans can audit why a recommendation happened.\n\nGood first issues:\n\n- [Add one buyer intent example for a real sourcing category](https://github.com/jinjihuang88-ui/maplebridge-open/issues/11)\n- [Add supplier capability examples for OEM and low-MOQ cases](https://github.com/jinjihuang88-ui/maplebridge-open/issues/12)\n\nIf this is useful, star the repo or open a small issue with the sourcing workflow you want represented.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjinjihuang88-ui%2Fmaplebridge-open","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjinjihuang88-ui%2Fmaplebridge-open","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjinjihuang88-ui%2Fmaplebridge-open/lists"}