Service claw research service

claw-research-service

Rendered from .ai/manifests/ on every publish. Rules for this service: CLAUDE.md · guide: service guide.

Property	Value
Directory	apps/claw-research-service
Port	4016
Database	postgresql
Test files	66 (vitest)
Internal packages	@claw/shared-auth, @claw/shared-constants, @claw/shared-entitlements, @claw/shared-rabbitmq, @claw/shared-types, @claw/shared-utilities

Persistence models

• FetchJob
• FetchStrategyConfig
• HostStrategyMemory
• PageCache
• ResearchRun
• RuntimeCrawlConfig
• RuntimeCrawlPage
• RuntimeCrawlRun
• SearchProvider
• SearchRun

HTTP API (26)

Method	Route	Source
GET	/health	health.controller.ts
POST	/internal/research/fetch	fetch-internal.controller.ts
POST	/internal/research/runs	research-internal.controller.ts
GET	/research/crawl/runs	runtime-crawl.controller.ts
POST	/research/crawl/runs	runtime-crawl.controller.ts
GET	/research/crawl/runs/:id	runtime-crawl.controller.ts
GET	/research/crawl/runs/:id/pages	runtime-crawl.controller.ts
POST	/research/fetch	fetch.controller.ts
GET	/research/fetch-strategies	fetch-strategy.controller.ts
PATCH	/research/fetch-strategies/:kind	fetch-strategy.controller.ts
GET	/research/fetch/jobs	fetch.controller.ts
GET	/research/fetch/jobs/:id	fetch.controller.ts
GET	/research/runs	research.controller.ts
POST	/research/runs	research.controller.ts
GET	/research/runs/:id	research.controller.ts
GET	/research/runtime-crawl/config	runtime-crawl-config.controller.ts
PATCH	/research/runtime-crawl/config	runtime-crawl-config.controller.ts
POST	/research/search	search.controller.ts
GET	/research/search-providers	search-provider.controller.ts
POST	/research/search-providers	search-provider.controller.ts
DELETE	/research/search-providers/:id	search-provider.controller.ts
GET	/research/search-providers/:id	search-provider.controller.ts
PATCH	/research/search-providers/:id	search-provider.controller.ts
POST	/research/search-providers/:id/test	search-provider.controller.ts
GET	/research/search/runs	search.controller.ts
GET	/research/search/runs/:id	search.controller.ts

Events (inferred from source; verify before a critical change)

• Publishes: log.server
• Consumes: none found