@hasna/sourcing

Open source supplier sourcing app — discover, enrich, and manage suppliers with Exa.ai.

Features

• Supplier Management: CRUD operations for suppliers with full contact tracking
• Exa.ai Discovery: Search the web for suppliers and manufacturers using AI-powered search
• Data Enrichment: Automatically enrich supplier records with emails, phone numbers, addresses, and LinkedIn profiles
• SQLite Database: Local-first with WAL mode for concurrent access
• CLI: Full command-line interface for all operations
• REST API: HTTP server for integration with other tools
• MCP Server: Model Context Protocol server for AI agent integration

Installation

bun install
bun run build

Usage

CLI

# Add a supplier
sourcing add "Acme Manufacturing" --category "Injection Molding" --website https://acme.com

# List suppliers
sourcing list

# Search suppliers
sourcing search "plastic"

# Discover suppliers via Exa.ai
sourcing discover "plastic injection molding manufacturers China" --save --category "Manufacturing"

# Enrich a supplier with additional data
sourcing enrich <supplier-id>

# Manage contacts
sourcing contact-add <supplier-id> "John Doe" --email [email protected] --primary

REST API

# Start the server
sourcing-serve

# Or
curl http://localhost:9877/health

# Create a supplier
curl -X POST http://localhost:9877/api/suppliers \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme Corp","category":"Manufacturing"}'

# Discover suppliers
curl -X POST http://localhost:9877/api/discover \
  -H "Content-Type: application/json" \
  -d '{"query":"electronics manufacturers Taiwan","save":true}'

# Enrich a supplier
curl -X POST http://localhost:9877/api/enrich \
  -H "Content-Type: application/json" \
  -d '{"supplierId":"<id>"}'

MCP Server

Add to your MCP configuration:

{
  "mcpServers": {
    "sourcing": {
      "command": "sourcing-mcp"
    }
  }
}

Available tools:

• list_suppliers — List all suppliers
• get_supplier — Get supplier details
• create_supplier — Create a new supplier
• update_supplier — Update a supplier
• delete_supplier — Delete a supplier
• search_suppliers — Search suppliers
• add_contact — Add a contact
• list_contacts — List contacts
• discover_suppliers — Discover via Exa.ai
• enrich_supplier — Enrich with additional data
• list_enrichment_jobs — List enrichment jobs

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | SOURCING_DB_PATH | SQLite database path | ~/.hasna/sourcing/sourcing.db | | SOURCING_PORT | API server port | 9877 |

Architecture

src/
  cli/          Command-line interface
  server/       REST API server
  mcp/          MCP server
  db/           Database layer (SQLite + Bun)
  services/     External integrations (Exa.ai)
  types/        TypeScript types

License

Apache-2.0