{
  "markdown": "# Awardopedia\n\nFree, searchable interface for U.S. federal contract award data sourced from [USASpending.gov](https://www.usaspending.gov).\n\n## Tech Stack\n\n- **Frontend**: React 18 + Vite 5, react-router-dom v6, Chart.js, lucide-react\n- **Backend**: Node.js 20 + Express 4, PostgreSQL 15\n- **AI**: Anthropic Claude API for contract analysis (paid credits)\n- **Payments**: Stripe Checkout for credit packs\n- **Auth**: Magic link email via SendGrid + JWT\n- **Hosting**: DigitalOcean App Platform\n- **DNS/CDN**: Cloudflare\n\n## Local Development\n\n### Prerequisites\n\n- Node.js 20+\n- PostgreSQL 15+\n- Python 3.10+ (for data sync scripts)\n\n### Setup\n\n```bash\n# Clone\ngit clone https://github.com/openclaw/awardopedia.git\ncd awardopedia\n\n# Database\npsql -d your_db -f scripts/schema.sql\n\n# API\ncd api\ncp ../.env.example .env   # Edit with your values\nnpm install\nnpm run dev               # Starts on :3001\n\n# Frontend (separate terminal)\ncd web\nnpm install\nnpm run dev               # Starts on :3000, proxies /api to :3001\n```\n\n### Environment Variables\n\nSee `.env.example` for all required variables. At minimum for local dev:\n\n```\nDATABASE_URL=postgresql://localhost:5432/awardopedia\nJWT_SECRET=any-dev-secret\nPORT=3001\n```\n\n## Project Structure\n\n```\nawardopedia/\n├── api/                  # Express API server\n│   ├── src/\n│   │   ├── db/           # Database connection + queries\n│   │   ├── middleware/    # Auth, credits, rate limiting\n│   │   ├── routes/       # API route handlers\n│   │   └── services/     # Claude AI, Stripe, SendGrid\n│   └── Dockerfile\n├── web/                  # React + Vite frontend\n│   ├── src/\n│   │   ├── components/   # Reusable UI components\n│   │   ├── pages/        # Route pages\n│   │   ├── styles/       # CSS tokens, global, components\n│   │   └── utils/        # API client, formatters, SEO\n│   └── public/\n├── scripts/\n│   ├── schema.sql        # PostgreSQL schema\n│   ├── ingest.py         # Bulk CSV ingestion\n│   └── sync.py           # Weekly USASpending API sync\n├── docs/\n│   ├── api.md            # API endpoint reference\n│   ├── data-model.md     # Database schema docs\n│   └── deployment.md     # Deployment guide\n└── assets/               # Brand logos\n```\n\n## Data\n\nAll contract data is sourced from USASpending.gov, the official open data source of federal spending information maintained by the U.S. Department of the Treasury as mandated by FFATA.\n\n- **Bulk import**: `python3 scripts/ingest.py --file contracts.csv`\n- **Weekly sync**: `python3 scripts/sync.py` (fetches last 7 days from USASpending API)\n\n## Business Model\n\n- Core data access (search, filter, browse): **Free**\n- AI analysis (contract insights, summaries): **Paid credits**\n  - Starter: 100 credits / $9\n  - Pro: 500 credits / $29\n  - Power: 2,000 credits / $79\n\n## License\n\nProprietary. Data sourced from USASpending.gov (public domain).\n",
  "bytes": 2858,
  "sha": "adec439e93b6b318457bd7d4adb4b677aa43d7aca9abbbfc3b945e6acc1b060f",
  "repo_slug": "grayson-sys/awardopedia",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_grayson_sys_awardopedia_08936eb9/readme"
}