Skip to content

[Integration] 1sdv/TripStar - You.com Search/Research travel-info tool #94

Description

@Emos21

Target Repository URL

https://github.com/1sdv/TripStar

You.com API(s)

search
research

Estimated Complexity

small

Integration Description

TripStar is an AI travel agent for one-stop trip planning (Python FastAPI + hello-agents backend, ~1930 stars, Chinese). Its planner agent uses amap/google for map data (POI, weather, geocode) but has no way to pull live web info a map API can't give — events, current opening hours/closures, visa rules, advisories, "best time to visit in 2026", itinerary ideas. This integration adds You.com Search (and Research) as an additive tool the planner can call for that live travel info, registered the same duck-typed way as the existing Google Maps tool and guarded by a youcom_api_key so nothing changes when unconfigured.

Target Repo Contributing Guidelines

https://github.com/1sdv/TripStar/blob/main/README.md

Planned Approach

  • New backend/app/services/youcom_service.py (self-contained: httpx + config) with search() -> GET ydc-index.io/v1/search and research() -> POST api.you.com/v1/research (lite), mapped to clean structured text; key-gated, never leaks the key
  • Register a duck-typed YoucomTool (youcom_web_search / youcom_research) on the planner agent when youcom_api_key is set, mirroring the GoogleMapService wrapper; additive, does not touch amap/google map logic
  • config.py: youcom_api_key added to Settings + runtime keys + the frontend settings dict
  • Deep stdlib unittest tests (mocked HTTP: request construction, mapping, error paths, count caps, adversarial) + live e2e for search + research

Status Checklist

  • Claimed this integration (self-assign)
  • Filed issue or opened discussion in target repo
  • Opened PR in target repo
  • PR merged or rejected

Links

Target repo issue: 1sdv/TripStar#35
Target repo PR: 1sdv/TripStar#36

Additional Notes

Fork: https://github.com/Cooperation-org/TripStar, branch feat/youcom-search. Note: sheet labels this JavaScript but the backend is Python (JS is only xhs signing helpers). Chinese repo — issue, PR and commits in Chinese with an English summary.

Metadata

Metadata

Assignees

Labels

api:researchUses You.com Research APIapi:searchUses You.com Search APIstatus:claimedSomeone is actively working on this integrationstatus:pr-openedPR filed in the target repo

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions