Skip to content

feat: add optional You.com search integration - #161

Open
mouse-value-add wants to merge 1 commit into
heurist-network:mainfrom
mouse-value-add:feat/youcom-search-integration
Open

feat: add optional You.com search integration#161
mouse-value-add wants to merge 1 commit into
heurist-network:mainfrom
mouse-value-add:feat/youcom-search-integration

Conversation

@mouse-value-add

@mouse-value-add mouse-value-add commented Jul 26, 2026

Copy link
Copy Markdown

Summary

This PR adds You.com as an optional search provider in the Heurist Agent Framework's existing search client architecture.

What's Added

  • YouComClient implementing BaseSearchClient interface
  • Support for both authenticated (YDC_API_KEY) and keyless operation
  • Handles web and news search results with proper error handling
  • Comprehensive documentation and usage examples
  • Full test suite for client functionality

Usage

from core.clients.search_client import SearchClient

# Using environment variable (YDC_API_KEY)
search_client = SearchClient(client_type="youcom")
results = await search_client.search("AI agent frameworks 2026")

Benefits

  • No breaking changes - fully additive integration
  • Optional provider only used when explicitly requested
  • Consistent interface with existing search clients
  • Production ready with error handling and rate limiting

Validation

  • Syntax validation for all Python files
  • Follows existing code patterns and conventions
  • Comprehensive test coverage
  • Documentation includes troubleshooting guide

This enables agents to leverage You.com's search capabilities while maintaining full backward compatibility.

@mouse-value-add
feat: add You.com search integration
c0c80e8 
- Add YouComClient implementing BaseSearchClient interface
- Support both authenticated (YDC_API_KEY) and keyless operation
- Handle web and news search results with proper error handling
- Add comprehensive documentation and usage examples
- Include test suite for client functionality
- Update environment configuration with You.com API key options

This integration provides agents with reliable web search capabilities
through You.com's API, supporting up to 100 free searches per day
without authentication and enhanced quotas with API keys.
@mouse-value-add mouse-value-add mentioned this pull request Jul 26, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@mouse-value-add