haylan/fastcrw-opencode-websearch
1
0 Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

Research: fastCRW /v1/search API contract #3

New Issue
Closed
opened 2026-10-03 13:44:10 +00:00 by haylan · 1 comment
haylan commented 2026-10-03 13:44:10 +00:00
Owner
Copy link
Copy source

Map: #1

Question

What is the fastCRW self-hosted POST /v1/search contract? Auth scheme and header, request fields and limits (query, limit, others), response shape (success, data[], error, snippet vs description), error codes, and rate/size limits. Also note anything the official crw-mcp exposes that the REST API makes unnecessary.

Map: #1 ## Question What is the fastCRW self-hosted `POST /v1/search` contract? Auth scheme and header, request fields and limits (`query`, `limit`, others), response shape (`success`, `data[]`, `error`, snippet vs description), error codes, and rate/size limits. Also note anything the official `crw-mcp` exposes that the REST API makes unnecessary.
haylan added the wayfinder:research label 2026-10-03 13:44:10 +00:00
haylan added a new dependency 2026-10-03 13:44:42 +00:00
#5 Grilling: config surface for endpoint and token
haylan commented 2026-10-03 13:46:58 +00:00
Author
Owner
Copy link
Copy source

Research resolved: findings in docs/research/fastcrw-search-api.md (uncommitted). Key points: POST /v1/search with {query, limit<=20, lang, tbs}; Bearer CRW_API_KEY (none needed self-hosted unless CRW_AUTH__API_KEYS set); base URL CRW_API_URL; response data is flat array on hosted but data.results on self-hosted, so parse both; results carry both description and snippet; errors are {success:false,error,error_code}. Left open for review.

Research resolved: findings in docs/research/fastcrw-search-api.md (uncommitted). Key points: POST /v1/search with {query, limit<=20, lang, tbs}; Bearer CRW_API_KEY (none needed self-hosted unless CRW_AUTH__API_KEYS set); base URL CRW_API_URL; response data is flat array on hosted but data.results on self-hosted, so parse both; results carry both description and snippet; errors are {success:false,error,error_code}. Left open for review.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
No labels wayfinder:research
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
haylan (Arthur Erlich)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Blocks
#5 Grilling: config surface for endpoint and token
haylan/fastcrw-opencode-websearch
Reference: haylan/fastcrw-opencode-websearch#3