[Integration] agents-flex/agents-flex — You.com SearchProvider for the agents-flex-websearch module

[mouse-value-add]

Source repo

https://github.com/agents-flex/agents-flex

Why selected

• 1049 stars, Apache-2.0, Java 8+ multi-module Maven project — inside the 200-2000 star band where PRs realistically land
• Very active: pushed 2026-09-06, outside contributions merged within the last weeks (PRs [Integration] mylxsw/aidea-server - You.com web search provider for the assistant backend #56/[Integration] alejandro-ao/mcp-server-example - optional You.com search provider #57/[Integration] JungHoonGhae/tossinvest-cli - You.com Research market context command #58, [Integration] Kalouk context (MCP) server for AI agents. #60, Alibaba-NLP/DeepResearch: You.com Search + Research API Integration #64, [Integration] mrkrsl/web-search-mcp - You.com search provider #68 all merged)
• agents-flex-websearch module ships a clean SearchProvider SPI with five existing providers (Bocha, Brave, Tavily, Baidu Qianfan, Firecrawl). Adding You.com is the same shape as the Tavily provider that an outside contributor landed in PR [Integration] mylxsw/aidea-server - You.com web search provider for the assistant backend #56 + [Integration] alejandro-ao/mcp-server-example - optional You.com search provider #57 + [Integration] JungHoonGhae/tossinvest-cli - You.com Research market context command #58
• Docs (docs/zh/chat/websearch.md) and a runnable demo (demos/websearch-demo) document each provider — clear precedent for provider + docs + demo changes

Candidate evaluation summary

Candidate	Stars	Verdict
agents-flex/agents-flex	1049	SELECTED — provider SPI, active, proven merge pattern
lessweb/deepcode-cli	2231	Viable runner-up (TS coding harness, MCP config docs) but above the preferred band and docs-only surface
chenxin-yan/crust	403	Skill generation framework; weak natural web-search fit

Integration type

Provider adapter: YouComSearchProvider implementing com.agentsflex.websearch.SearchProvider, following the existing Tavily/Brave/Firecrawl provider pattern (OkHttp + FastJSON2, no new dependencies).

Distribution surface leveraged

Existing SearchProvider SPI in agents-flex-websearch (provider abstraction).

API details (verified via You.com docs)

• Endpoint: POST https://ydc-index.io/v1/search
• Auth: X-API-Key header (YDC_API_KEY)
• Request: {"query", "count", "include_domains", "exclude_domains"}
• Response: results.web[] with title, description, url

Setup / env vars

export YDC_API_KEY="your-api-key"   # https://you.com/platform/api-keys

SearchProvider provider = new YouComSearchProvider(System.getenv("YDC_API_KEY"));
WebSearchTool searchTool = new WebSearchTool(provider);

Usage example

String results = searchTool.webSearch("Java 17 new features", null, null);

Validation performed

• mvn -pl agents-flex-websearch -am compile -DskipTests — pass
• mvn -pl agents-flex-websearch test — 6/6 pass (3 new + 3 existing)
• Default behavior unchanged: provider is opt-in, only instantiated explicitly

Branch / PR

• Branch: https://github.com/mouse-value-add/agents-flex/tree/feat/youcom-search-integration
• OSS PR: feat(websearch): add You.com search provider agents-flex/agents-flex#69

Status

PR open, awaiting maintainer review.

[mouse-value-add]

Update — PR opened

• Branch: https://github.com/mouse-value-add/agents-flex/tree/feat/youcom-search-integration
• OSS PR: feat(websearch): add You.com search provider agents-flex/agents-flex#69

Integration delivered

• Type: Provider adapter — YouComSearchProvider implementing com.agentsflex.websearch.SearchProvider
• Distribution surface: the existing SearchProvider SPI in agents-flex-websearch (same surface the Tavily provider used in PRs [Integration] mylxsw/aidea-server - You.com web search provider for the assistant backend #56/[Integration] alejandro-ao/mcp-server-example - optional You.com search provider #57/[Integration] JungHoonGhae/tossinvest-cli - You.com Research market context command #58)
• Files: provider + unit test (stub OkHttp interceptor, FirecrawlSearchProviderTest pattern) + docs section in docs/zh/chat/websearch.md + commented demo line in demos/websearch-demo

Setup / env vars

export YDC_API_KEY="your-youcom-api-key"   # https://you.com/platform/api-keys

SearchProvider provider = new YouComSearchProvider(System.getenv("YDC_API_KEY"));
WebSearchTool searchTool = new WebSearchTool(provider);

Usage example

String results = searchTool.webSearch("Java 17 new features", null, null);

Fallback / error behavior

• HTTP errors throw SearchException with status code + body (matches Firecrawl provider convention)
• Missing results/results.web → empty list
• Entries missing title or url are skipped
• Fully opt-in: no behavior change unless the provider is explicitly constructed

Tests run

• mvn -pl agents-flex-websearch -am compile -DskipTests — pass
• mvn -pl agents-flex-websearch test — 6/6 pass (3 new YouComSearchProviderTest + 3 existing FirecrawlSearchProviderTest)

Status

PR open, awaiting maintainer review.