From eafbe5e06d23aa83152a85fb38b691d294de6d13 Mon Sep 17 00:00:00 2001
From: Travis Fischer <fisch0920@gmail.com>
Date: Wed, 9 Apr 2025 22:12:33 +0700
Subject: [PATCH] docs: add youtube to docs

---
 docs/mint.json         |  1 +
 docs/tools/youtube.mdx | 39 +++++++++++++++++++++++++++++++++++++++
 readme.md              |  1 +
 3 files changed, 41 insertions(+)
 create mode 100644 docs/tools/youtube.mdx

diff --git a/docs/mint.json b/docs/mint.json
index 9a4d309..4e3fb80 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -97,6 +97,7 @@
         "tools/wikidata",
         "tools/wikipedia",
         "tools/wolfram-alpha",
+        "tools/youtube",
         "tools/zoominfo"
       ]
     }
diff --git a/docs/tools/youtube.mdx b/docs/tools/youtube.mdx
new file mode 100644
index 0000000..b1fa44f
--- /dev/null
+++ b/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'
+})
+```
diff --git a/readme.md b/readme.md
index 97cabca..a9dde29 100644
--- a/readme.md
+++ b/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]