feat(v2): migrate Go SDK from Firecrawl API v1 to v2#1

Open

ArmandoHerra wants to merge 33 commits intomainfrom

feat/sdk-v2-api-migration

Commits on Mar 15, 2026

fix(sdk): resolve 6 foundation bugs in preparation for v2 API migration
ArmandoHerra
committed
refactor(sdk): split monolithic firecrawl.go into modular file structure
ArmandoHerra
committed
ci(sdk): add Makefile, golangci-lint, GitHub Actions CI, and Dependabot
ArmandoHerra
committed
fix(ci): resolve lint and test failures in GitHub Actions pipeline
ArmandoHerra
committed
fix(ci): skip coverage threshold when no unit tests exist
ArmandoHerra
committed
ci(sdk): bump actions to Node.js 24 and expand Go test matrix to 1.22-1.25
ArmandoHerra
committed
fix(ci): migrate golangci-lint config to v2 format and drop Go 1.22 from matrix
ArmandoHerra
committed
fix(ci): move gofumpt to formatters section for golangci-lint v2
ArmandoHerra
committed
fix(ci): remove gosimple linter (merged into staticcheck in v2)
ArmandoHerra
committed
fix(sdk): resolve errcheck and staticcheck lint issues in helpers.go
ArmandoHerra
committed
feat(sdk)!: define all v2 API types and update endpoints to v2 field names
ArmandoHerra
committed
feat(sdk)!: add context.Context to all public methods and internal helpers
ArmandoHerra
committed
refactor(sdk): migrate ScrapeURL to /v2/scrape with struct marshaling
ArmandoHerra
committed
refactor(sdk): migrate crawl endpoints to /v2/crawl with struct marshaling
ArmandoHerra
committed
refactor(sdk): update monitorJobStatus to v2 crawl status values
ArmandoHerra
committed
refactor(sdk): migrate MapURL to /v2/map with struct marshaling
ArmandoHerra
committed
docs(sdk): add MIG-10 and MIG-11 verification checkpoint entries to changelog
ArmandoHerra
committed
docs(sdk): rewrite README for v2 API with updated examples and project structure
ArmandoHerra
committed
feat(errors): add typed error system with APIError and sentinel errors
ArmandoHerra
committed
feat(security)!: add URL validation, ID sanitization, and unexport APIKey
ArmandoHerra
committed
test(sdk): add unit test foundation with mock server and 17 smoke tests
ArmandoHerra
committed
test(sdk): add comprehensive unit tests for all existing methods (97 tests)
ArmandoHerra
committed
feat(client): add HTTP client options, User-Agent header, and SDK version
ArmandoHerra
committed
feat(search): implement Search endpoint for v2 API
ArmandoHerra
committed
feat(batch): implement Batch Scrape endpoints for v2 API
ArmandoHerra
committed
feat(extract): implement Extract endpoints for v2 API
ArmandoHerra
committed
test(sdk): add remaining coverage tests for new endpoints (155 total)
ArmandoHerra
committed
feat(pagination): add PaginationConfig support and manual page methods
ArmandoHerra
committed
test(e2e): modernize integration tests for v2 and add new endpoint E2E tests
ArmandoHerra
committed
docs(sdk): comprehensive README rewrite and CONTRIBUTING.md for v2 SDK
ArmandoHerra
committed
docs(sdk): add CHANGELOG.md in Keep a Changelog format and update DX files
ArmandoHerra
committed
docs(sdk): fix fork link and remove duplicate license note in README
ArmandoHerra
committed
docs(sdk): remove external specs reference from CONTRIBUTING.md
ArmandoHerra
committed