[Integration] Decade-qiu/CookHero - You.com Search tool

[tra371]

Target Repository URL

https://github.com/Decade-qiu/CookHero

You.com API(s)

search

Estimated Complexity

medium

Integration Description

CookHero uses web search to supplement its recipe and nutrition knowledge base with real-time information - food news, seasonal ingredients, nutrition research, and restaurant recommendations. This integration will replace the existing Tavily search with You.com Search and add You.com Deep Research for complex multi-source analysis queries.

Target Repo Contributing Guidelines

No response

Planned Approach

1. Replace the existing Tavily-based web search with You.com Search API (https://ydc-index.io/v1/search) across two integration points:

• app/tools/web_search.py — high-level decision and execution service
• app/agent/tools/common/websearch.py — Agent-facing BaseTool

2. Add a new Deep Research tool using You.com Research API (https://ydc-index.io/v1/research) as a standalone Agent tool for complex analysis queries (nutrition research, multi-source recipe comparisons, etc.)
3. New app/integrations/youcom/client.py module will handle both APIs with proper error handling, timeout management, and response formatting consistent with the existing tool pattern.
4. Configuration will use the existing YOUCOM_API_KEY environment variable via the project's standard config loading pipeline.

Status Checklist

• Claimed this integration (self-assign)
• Filed issue or opened discussion in target repo
• Opened PR in target repo
• You.com API calls send the standard integration User-Agent (youdotcom-integration/<owner>-<repo>)
• You.com links in contributed docs carry the standard UTM parameters (utm_source=<owner>-<repo>&utm_medium=oss_integration&utm_campaign=YYYY-MM-<initiative>)
• PR merged or rejected

Links

Target repo issue: Decade-qiu/CookHero#97
Target repo PR: Decade-qiu/CookHero#98

Additional Notes

No response