Skip to content

Add --valuable-result-positions to search feedback#164

Open
dtaivpp wants to merge 1 commit into
mainfrom
david/search-feedback-result-positions
Open

Add --valuable-result-positions to search feedback#164
dtaivpp wants to merge 1 commit into
mainfrom
david/search-feedback-result-positions

Conversation

@dtaivpp

@dtaivpp dtaivpp commented Jul 24, 2026

Copy link
Copy Markdown

Summary

  • Add --valuable-result-positions to firecrawl search-feedback and firecrawl feedback (search endpoint), forwarding the API's new valuableResultPositions field (Collect search feedback result positions firecrawl#4109) so agents can attribute usefulness to specific data.web results by 1-indexed position.
  • Update both skills: jq snippets now print 1-indexed positions alongside URLs, and feedback guidance requires exhaustive position marking (unlisted results are treated as not useful) with --valuable-sources reserved for URLs outside data.web — no double-reporting the same result.
  • Accepts comma-separated lists ("1,3") or JSON arrays ([1,3]), same parsing as --page-numbers.
  • The field is only sent when the flag is provided, so the CLI stays compatible with API deployments that predate position-based feedback.

Tests

  • npm run build
  • npx vitest run — 23 files, 362 tests passing

🤖 Generated with Claude Code


View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.

Wire the API's new valuableResultPositions field through both feedback
commands so agents can attribute usefulness to specific data.web
results by 1-indexed position. Skills now surface positions in jq
extraction snippets and require exhaustive position marking (unlisted
results count as not useful), with valuableSources reserved for URLs
outside data.web.

Requires an API with position-based search feedback support
(firecrawl/firecrawl#4109); the field is only sent when the flag is
provided.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant