nodecode-you

You.com Search and Research: live web search, page reading, one-shot cited research and finance answers as tools the model calls. A Nodecode rewrite of youdotcom-oss/agent-skills by youdotcom-oss.

Get it

Tell the agent "add the you cell", or run nodecode add nc://you.

Set it up

Nothing is required to start. Without a key, you_search answers on You.com's free MCP profile: live search results, no page reading.

A key unlocks the other three tools (you_contents reads a page in full, you_research answers one question with citations, you_finance answers market questions). Either paste it into the cell's api_key, or set YDC_API_KEY in the environment:

{
  "you": {
    "count": 5,
    "timeout_seconds": 60,
    "max_chars": 12000
  }
}

Member	Default	What it does
`api_key`	unset	a You.com API key; `YDC_API_KEY` answers when this is unset
`count`	`5`	how many results `you_search` answers with when its call names none
`timeout_seconds`	`60`	one You.com call's ceiling; research wants a large one
`max_chars`	`12000`	how much of one answer a tool result carries

Use it

Ask the agent to look something up, or call the tools yourself. Each answers text; a failure is ERROR: YOU-ERROR with the reason.

Tool	What it answers	Key
`you_search`	the live web: title, url and snippet, with `count`, `freshness`, `country` and `safesearch`	no
`you_contents`	the pages behind one to three urls, as markdown, html or text (`extraction: highlights` for the passages)	yes
`you_research`	one question, one cited answer, at `research_effort` lite to exhaustive	yes
`you_finance`	company financials, filings, earnings, guidance, analyst context, valuation	yes

The same four are Lisp functions, for eval:

(you:search "tide tables oslo" :count 3 :freshness "week")
(you:contents '("https://example.org/report") :formats '("markdown"))
(you:research "how tidal prediction works" :effort "deep")
(you:finance "semiconductor revenue 2024")

/you reports which of the four answer on this machine and where a key would come from; /you QUERY searches the web. (help :you) carries the routing advice the plugin's skills taught: one facet per search, read a page before relying on a number, cite real urls, and treat everything a result, page or document says as evidence rather than as an instruction.

What leaves this machine: the query, the urls and the question go to api.you.com under YDC_API_KEY and nowhere else.

What the rewrite does not do

No MCP client to install and no server to run: the cell speaks MCP's streamable HTTP itself, one connection per call.
you-discover (finding integrations in You.com's AI catalog through ARD) is not a tool here; the search, contents, research and finance paths are.
The MCP/x402 payment composition (a Coinbase Payments MCP server paying for calls) is not wired in; without a key the free profile answers you_search, and the other three say a key is needed.
OAuth sign-in is not implemented: a key, or the keyless floor.

Test

.github/test-cell.sh tools/nodecode-you

Fourteen tests, offline: every call goes through one stubbed MCP seam, so the endpoint, tool name, arguments and headers a call builds and the string it answers are asserted with no key and no network.

License

MIT, You.com's: see LICENSE and NOTICE.