antiv/mate: You.com search tool integration

[mouse-value-add]

You.com Search Integration for antiv/mate - IMPLEMENTATION COMPLETE

Source Repository

https://github.com/antiv/mate

Selection Rationale

Selected antiv/mate (87⭐) as the best candidate for You.com integration due to:

Perfect Integration Fit:

• Production-ready multi-agent orchestration engine with comprehensive tool ecosystem
• Built on Google ADK with 50+ LLM providers and MCP protocol support
• Already mentions "Search" as a built-in tool but no specific search provider
• Clear tool configuration system and extensible architecture
• Multi-tenant design with RBAC - web search would enhance all agent categories

Active Maintenance:

• Very recent commits (pushed 2026-08-18T19:02:25Z - today!)
• Well-maintained codebase with comprehensive documentation
• Only 1 open issue indicating manageable maintainer workload
• Professional contribution guidelines and development setup

Technical Excellence:

• Python-based (53% historical merge rate vs TypeScript 17%)
• FastAPI backend with clean architecture
• MCP-native with existing tool abstraction patterns
• Self-hosted with web dashboard and comprehensive configuration
• Apache 2.0 compatible licensing

Implementation Details - COMPLETE ✅

Integration Type: Built-in Tool Addition
Environment Variables:

• YDC_API_KEY - Optional You.com API key for authenticated access
• Uses You.com MCP API at https://api.you.com/mcp

Usage Example:

{
  "youcom_search": true,
  "google_drive": true,
  "memory_blocks": {
    "enabled": true
  }
}

Implementation Complete:

• ✅ Added youcom_search tool to ToolFactory
• ✅ Created shared/utils/tools/youcom_tools.py with MCP integration
• ✅ Updated .env.example with YDC_API_KEY documentation
• ✅ Enhanced README.md and AGENTS.md with tool documentation
• ✅ Added configuration examples and usage instructions
• ✅ Updated existing tests to include new tool method
• ✅ Maintains backward compatibility - no breaking changes
• ✅ Follows MATE's established patterns and architecture

Validation Performed:

• ✅ Python syntax validation and import testing
• ✅ ToolFactory integration and method registration
• ✅ Configuration documentation and examples
• ✅ No breaking changes to existing tool ecosystem
• ✅ Follows MATE's tool patterns (LangchainTool wrapper, ADK compatibility)
• ✅ Environment variable configuration documented
• ✅ Error handling and logging implemented
• ✅ 402 payment flow handling for keyless access

Qualification Results

• ✅ Stars: 87 (within 50-500 sweet spot)
• ✅ Last push: 2026-08-18T19:02:25Z (today - within 30 days)
• ✅ Language: Python (preferred, 53% merge rate)
• ✅ Competing provider check: No existing search providers detected
• ✅ Search integration fit: Mentions "Search" as built-in tool, core to multi-agent research workflows
• ✅ Open issues: 1 (excellent maintainer bandwidth)

Implementation Links

• Source Repository: https://github.com/antiv/mate
• Branch: https://github.com/mouse-value-add/mate/tree/feat/youcom-search-integration
• Pull Request: feat: add optional You.com search integration antiv/mate#69

Technical Implementation Summary

Files Added:

• shared/utils/tools/youcom_tools.py - You.com MCP API integration with proper error handling

Files Modified:

• shared/utils/tools/tool_factory.py - Added youcom_search tool creator method
• .env.example - Added YDC_API_KEY documentation
• README.md - Updated tools list to mention You.com Search
• AGENTS.md - Added You.com tool documentation and configuration examples
• shared/test/test_core_functionality.py - Added youcom_search method tests

Integration Features:

• Uses You.com MCP API (https://api.you.com/mcp) with you-search tool
• Optional authentication via YDC_API_KEY environment variable
• Keyless access support with 402 payment flow messaging
• Formatted search results (title, snippet, URL) for agent consumption
• Comprehensive error handling and logging
• Follows LangchainTool wrapper pattern for ADK compatibility
• No breaking changes - purely additive feature

The integration is complete and ready for maintainer review!