yichen-unified-search

Routes keyword queries to bounded public web and platform search backends and normalizes results into candidate envelopes.

2.0k|274|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mcncarl/yichen-skills --skill yichen-unified-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yichen-unified-search
Source: https://github.com/mcncarl/yichen-skills/tree/main/yichen-unified-search
Command: npx skills add https://github.com/mcncarl/yichen-skills --skill yichen-unified-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires idna, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Searching the public web and multiple social platforms usually means juggling many CLIs, APIs, and login states with inconsistent output formats. This Skill plans one bounded, read-only route per query and normalizes results into a single reviewable candidate schema.

Core Features & Use Cases

  • Offline route planning: route_search.py selects one bounded backend (AnySearch, AI HOT, Firecrawl, Zhihu, Weibo, YouTube, X/Grok, and more) and emits explicit steps, authorization state, and limitations without calling any service.
  • Unified candidate envelopes: Bundled adapters output schema 1.0 with candidates, coverage, provenance, and sanitized errors, plus short-lived HMAC receipts for verifying current-search candidates.
  • Platform coverage: Discovers public content on GitHub, Zhihu, WeChat Official Accounts, Weibo, Xiaohongshu, Douyin, Toutiao, X/Twitter, Bilibili, YouTube, and Xiaoyuzhou, with strict read-only and login-state boundaries.
  • Use Case: Ask for recent public discussion of a product across Weibo and X; the planner emits bounded steps, adapters return normalized candidates, and you verify only the items you intend to cite.

Quick Start

Ask the assistant to search a topic on a specific platform with a time range and result limit, for example: search Weibo for public posts about iPhone 18 from the last 30 days and return up to 20 candidates.

Frequently Asked Questions about yichen-unified-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search multiple social platforms from one tool?

Run the offline route_search.py planner with a query, platform, time range, and limit. It selects one bounded route per query, emits the exact steps to execute, and bundled adapters return normalized candidate envelopes you can review.

How to search X/Twitter posts without the official API?

X search uses the official Grok CLI OAuth with native x_search, in Quick or Research depth modes. Anonymous FxTwitter is allowed only after explicit quota exhaustion, and authenticated OpenCLI/xreach fallback stays disabled unless the user authorizes it for the current task.

Does this search tool access private accounts or perform write actions?

No. All routes are read-only public or authenticated-public discovery. It never posts, comments, likes, follows, reads private feeds or collections, controls the WeChat UI, downloads media, or archives pages.

What external tools are required for each search route?

Only install runtimes for routes you use: AnySearch for general web, Grok CLI for X, gh for GitHub, yt-dlp or a YouTube Data API key for YouTube, bili for Bilibili, OpenCLI for several Chinese platforms, and a Firecrawl key for site maps.

Why does a search return candidates instead of verified facts?

Search snippets, rankings, and summaries are discovery text, not evidence. Candidates carry verification status 'candidate'; only opening the original URL of a signed current-search candidate enriches it, and even that does not prove a factual claim.