docs: add youtube to docs

docs/mint.json

@@ -97,6 +97,7 @@
         "tools/wikidata",
         "tools/wikipedia",
         "tools/wolfram-alpha",
+        "tools/youtube",
         "tools/zoominfo"
       ]
     }

docs/tools/youtube.mdx

@@ -0,0 +1,39 @@
+---
+title: YouTube
+description: YouTube data API v3 client for searching YT videos and channels.
+---
+
+- package: `@agentic/youtube`
+- exports: `class YouTubeClient`, `namespace youtube`
+- env vars: `YOUTUBE_API_KEY`
+- [source](https://github.com/transitive-bullshit/agentic/blob/main/packages/youtube/src/youtube-client.ts)
+- [youtube api docs](https://developers.google.com/youtube/v3)
+  - [search docs](https://developers.google.com/youtube/v3/docs/search/list)
+
+## Install
+
+<CodeGroup>
+```bash npm
+npm install @agentic/youtube
+```
+
+```bash yarn
+yarn add @agentic/youtube
+```
+
+```bash pnpm
+pnpm add @agentic/youtube
+```
+
+</CodeGroup>
+
+## Usage
+
+```ts
+import { YouTubeClient } from '@agentic/youtube'
+
+const youtube = new YouTubeClient()
+const res = await youtube.searchVideos({
+  query: 'cute kittens'
+})
+```

readme.md

@@ -222,6 +222,7 @@ Full docs are available at [agentic.so](https://agentic.so).
 | [Wikidata](https://www.wikidata.org/wiki/Wikidata:Data_access)                  | `@agentic/wikidata`             | [docs](https://agentic.so/tools/wikidata)             | Basic Wikidata client.                                                                                                                                                                                                                                         |
 | [Wikipedia](https://www.mediawiki.org/wiki/API)                                 | `@agentic/wikipedia`            | [docs](https://agentic.so/tools/wikipedia)            | Wikipedia page search and summaries.                                                                                                                                                                                                                           |
 | [Wolfram Alpha](https://products.wolframalpha.com/llm-api/documentation)        | `@agentic/wolfram-alpha`        | [docs](https://agentic.so/tools/wolfram-alpha)        | Wolfram Alpha LLM API client for answering computational, mathematical, and scientific questions.                                                                                                                                                              |
+| [YouTube](https://developers.google.com/youtube/v3)                             | `@agentic/youtube`              | [docs](https://agentic.so/tools/youtube)              | YouTube data API v3 for searching YT videos and channels.                                                                                                                                                                                                      |
 | [ZoomInfo](https://api-docs.zoominfo.com)                                       | `@agentic/zoominfo`             | [docs](https://agentic.so/tools/zoominfo)             | Powerful B2B person and company data enrichment.                                                                                                                                                                                                               |
 
 > [!NOTE]