ca-marketplace-scraper/packages/api-server/.ruler/AGENTS.md

packages/api-server

Scope

• This package is the HTTP transport layer over @marketplace-scrapers/core.
• Route files in src/routes/*.ts should parse inputs, call core, and map responses/errors.

Keep Thin

• Do not move scraping, parsing, selector, or cookie-loading logic into routes.
• If route code starts branching on marketplace behavior, push that behavior back into packages/core.

Route Conventions

• Register new routes in src/index.ts.
• Follow existing input precedence where present: query header first, then q search param.
• Preserve existing response shape style: Response.json(...), 400 for bad input/errors, 404 for empty result sets, 200 for success.
• Keep query parameter names aligned with the MCP server because MCP builds URLs against these endpoints.

Verify

• bun test packages/api-server/test
• bun run --cwd packages/api-server build
• bun run ci