feat(crewai-tools): add SerpdiveSearchTool

[edendalexis]

Add SerpdiveSearchTool

Adds a search tool for SERPdive, an AI search API that returns answer-ready web content: every result carries the actual text of the page (url, title, date, content), already extracted, cleaned, and sized for LLM consumption, so agents can quote and cite straight from the tool output. On a public, replayable 1,000-question benchmark, SERPdive runs at the same speed as Tavily, feeds your LLM 20.2% fewer tokens, and wins 60.7% of decided quality duels.

What's included

• lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/: SerpdiveSearchTool (sync _run + async _arun) over the official serpdive SDK, following the structure and current style of the existing search tools (import guard, package_dependencies, env_vars, JSON string output) + tool README
• Exports in crewai_tools/__init__.py and crewai_tools/tools/__init__.py (imports and __all__), serpdive optional dependency group in lib/crewai-tools/pyproject.toml
• lib/crewai-tools/tests/tools/serpdive_search_tool_test.py: 4 stubbed unit tests (no network), passing locally; the tool was also run live against the production API
• Docs page docs/edge/en/tools/search-research/serpdivesearchtool.mdx + overview card + docs/docs.json nav entry (edge only, no frozen docs/v* touched)
• lib/crewai-tools/tool.specs.json regenerated with generate_tool_specs.py: the diff is additive only (the new tool's entry), no existing entry changed

Notes

• Auth via SERPDIVE_API_KEY (free key, no card required). No country or locale parameter: the language of the query picks where the search runs automatically.
• Heads-up on exclude-newer = "3 days": the serpdive SDK's latest release was published on 2026-07-18, so uv sync --all-extras resolves it once the release is more than 3 days old. No config change is included; if CI runs before then and you prefer, we can add a temporary exclude-newer-package override instead.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: afe42913-362d-40a8-9fa3-bcbd1f2d1d7a

📥 Commits

Reviewing files that changed from the base of the PR and between e78771b and bbe5b68.

📒 Files selected for processing (4)

• docs/edge/en/tools/search-research/serpdivesearchtool.mdx
• lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/README.md
• lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/serpdive_search_tool.py
• lib/crewai-tools/tool.specs.json

🚧 Files skipped from review as they are similar to previous changes (2)

• lib/crewai-tools/tool.specs.json
• lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/serpdive_search_tool.py

---

📝 Walkthrough

Walkthrough

Changes

SERPdive Search Tool

Layer / File(s)	Summary
Tool contract and package wiring lib/crewai-tools/pyproject.toml, lib/crewai-tools/tool.specs.json, lib/crewai-tools/src/crewai_tools/.../__init__.py	Adds the optional serpdive dependency, tool schemas, environment configuration, and public package exports.
Search implementation and validation lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/serpdive_search_tool.py, lib/crewai-tools/tests/tools/serpdive_search_tool_test.py	Implements SERPdive sync and async searches, JSON response formatting, optional parameters, and mocked behavioral tests.
Documentation and tool discovery lib/crewai-tools/src/crewai_tools/tools/serpdive_search_tool/README.md, docs/edge/en/tools/search-research/*, docs/docs.json	Documents installation, configuration, usage, parameters, output, references, and adds the tool to the search-research documentation index.

Sequence Diagram(s)

sequenceDiagram
  participant Agent
  participant SerpdiveSearchTool
  participant SERPdive
  Agent->>SerpdiveSearchTool: Submit query
  SerpdiveSearchTool->>SERPdive: Execute search with configured parameters
  SERPdive-->>SerpdiveSearchTool: Return search response
  SerpdiveSearchTool-->>Agent: Return formatted JSON

Loading

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 20.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely states the main change: adding SerpdiveSearchTool to crewai-tools.
Description check	✅ Passed	The description matches the changeset and accurately summarizes the new tool, docs, tests, exports, and dependency updates.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[edendalexis]

Update while this is open: SERPdive now has a free tier, which changes the calculus for this integration.

model: "krill" is free and unlimited under fair use — no card, no credits to spend, no trial clock. It returns about 700 tokens per search (roughly half what the usual alternatives send), one request at a time, at low priority. The paid models are unchanged.

Why it matters here: the usual objection to adding a search provider is that reviewers and users need a paid key just to try it. That objection is gone — anyone can run this integration end to end for free, including whoever reviews this PR.

Nothing in this PR needs to change for that: the default stays mako, and krill is opt-in via the existing model parameter. Happy to add a line to the docs here if you'd like the free tier called out explicitly.