feat: add optional you.com search plugin (keyless MCP server + you-web skill) - #3
Open
mouse-value-add wants to merge 1 commit into
Open
mouse-value-add wants to merge 1 commit into
mouse-value-add wants to merge 1 commit into
Conversation
… server) New in-tree plugin (allowed for new plugins per CLAUDE.md): - plugins/you-com/.claude-plugin/plugin.json registers the You.com MCP server (https://api.you.com/mcp?profile=free, keyless) so installs get the you-search tool with no API key or signup - skills/you-web routes web search / URL reading / cited synthesis to the available you-* tools and documents the YDC_API_KEY upgrade path for you-contents and you-research - marketplace.json entry (category: productivity, alongside insane-search) - README badge 18 -> 19 and a row in the Research & web table Fully opt-in: nothing changes until /plugin install you-com@gptaku-plugins. Skill content adapted from youdotcom-oss/agent-skills (MIT).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
A new
you-complugin that gives Claude Code sessions current web search through the You.com MCP server — search the web, read URLs, get cited answers. It fits next toinsane-search(which solves access to blocked pages) by covering the discovery side: finding current sources in the first place.Why through the marketplace
insane-searchcovers page access without keys, andinsane-researchbuilds reports, but neither is a search engine — there's no plugin in the Research & web category that takes a query and returns ranked, current web results. This adds that as an in-tree plugin using the existingmcpServersmechanism in the plugin manifest, which I understood is allowed for new plugins per CLAUDE.md ("신규는 in-tree 임시 허용").What changed
plugins/you-com/.claude-plugin/plugin.json— registershttps://api.you.com/mcp?profile=free(keyless HTTP MCP server). This profile exposes theyou-searchtool with no API key and no signup.plugins/you-com/skills/you-web/SKILL.md— routes web-search / URL-reading / cited-synthesis requests to the availableyou-*tools, with a selection order and a graceful fallback when only the keylessyou-searchis available (gather sources by search, read pages with the host's web-fetch tool).plugins/you-com/README.md+LICENSE(MIT, matching the other plugins)..claude-plugin/marketplace.json— one entry (you-com, categoryproductivity, same category asinsane-search).README.md— badge 18 → 19, one row in the Research & web table.Skill content is adapted from youdotcom-oss/agent-skills (MIT), which packages the same You.com skills for Claude Code, Codex, Copilot CLI and others (
/plugin marketplace add youdotcom-oss/agent-skills).Setup
/plugin install you-com@gptaku-pluginsis enough, andyou-searchworks immediately.you-contents) and one-shot cited research (you-research) setYDC_API_KEY(free key from you.com/platform/api-keys) and point the server athttps://api.you.com/mcp. Documented in the skill and README.Usage
Opt-in / failure behavior
you-search+ host web-fetch instead of failing.Validation
python3 tools/validate_marketplace.py— passes for this change; the one remaining error (insane-crawl: unpublished development source must not be registered) is pre-existing on main (current CI run onmainfails at the same step) and untouched by this PR.python3 tools/validate_commands.py— OK (24 command files scanned).python3 tools/validate_skill_contracts.py— OK (28 assertions).python3 tools/test_gptaku_doctor.py— 14 tests OK.initialize+tools/listagainsthttps://api.you.com/mcp?profile=freeconfirmed the keyless server responds and exposesyou-search.tools/test_validate_marketplace.pyrequires Python ≥3.12 (typing.override); only 3.11 is available in my environment, but this PR doesn't touch that validator or its subject matter — it runs on 3.12 in CI.Happy to adjust the shape if you'd prefer this as a submodule with its own repo instead of in-tree, or a different category — I followed the
insane-crawlprecedent for in-tree structure and kept the manifest minimal.