@orchyn/mcp 1.7.1 → 1.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -4
- package/dist/shared/tools-def.js +7 -7
- package/dist/shared/tools.js +7 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -40,11 +40,11 @@ npx @orchyn/mcp login # one-time sign-in (Google)
|
|
|
40
40
|
|------|---------|-------------|
|
|
41
41
|
| `analyze_post` | first free* | **Preferred.** Analyze any post (video, image, carousel/slideshow) from a TikTok/Instagram/YouTube/X-Twitter/Douyin/Xiaohongshu/Bilibili URL — imports the media and runs AI analysis over the actual content (video frames, carousel images, caption). Returns a `jobId` to poll via `GET /ai/analyze-post`. *First analysis free per workspace via the dashboard free grant.* |
|
|
42
42
|
| `get_social_media` | 1 | Fetch a post's media from a URL: `contentType` (video/image/carousel/slideshow), title, caption, author, stats, direct media URLs **+ inline thumbnail image in chat**. |
|
|
43
|
-
| `discover_social_posts` | 2 | **Preferred.** Find recent posts (video/image/carousel/slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili
|
|
43
|
+
| `discover_social_posts` | 2 | **Preferred.** Find recent posts (video/image/carousel/slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili. Each post includes title/caption, views/likes/comments, author, `externalUrl` + **inline thumbnails (4 at a time)** — see *Images in chat* below. Supports `limit`/`offset` pagination (“next”). |
|
|
44
44
|
| `get_user_posts` | 2 | List recent posts by a creator handle (e.g. `@zoundsapp`) on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili — title/caption, `thumbnailUrl`, `externalUrl`, views/likes/comments, **inline thumbnails (up to 4)**. Use to scan a whole profile or spot patterns across an account. |
|
|
45
|
-
| `analyze_creator_profile` | 15 | Deep-dive a whole creator profile on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetches recent posts, runs multimodal
|
|
45
|
+
| `analyze_creator_profile` | 15 | Deep-dive a whole creator profile on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetches recent posts, runs multimodal AI on up to 3, then synthesizes a profile report — creator summary, niche, content themes, hook styles, strengths/weaknesses, engagement patterns, audience insights, variation ideas, collaboration fit. |
|
|
46
46
|
| `get_post_comments` | 2 | Fetch top comments for a post URL on TikTok, Instagram, YouTube, Douyin, X/Twitter or Bilibili, plus keyword clusters from TikTok Analytics when available — audience sentiment/audience-signal analysis. |
|
|
47
|
-
| `search_creators` | 2 | Search creators by niche/keyword
|
|
47
|
+
| `search_creators` | 2 | Search creators by niche/keyword on TikTok, Instagram, Xiaohongshu, YouTube or Douyin — username, nickname, follower count, signature, verified status. Use to find influencers to vet or analyze. |
|
|
48
48
|
| `get_similar_creators` | 2 | Find lookalike creators for a given handle (TikTok similar-user recommendations or Instagram similar users) — “if this creator works, here are more like them”. |
|
|
49
49
|
| `discover_sounds` | 2 | Discover trending sounds/music for a keyword on TikTok or Instagram — sound choice is a huge ranking signal for TikTok virality. Returns title, artist, duration, play/cover URLs. |
|
|
50
50
|
| `understand_social_post` | 10 | Import a post URL **and** analyze it with multimodal AI over the actual video/images: factual `whatHappens` description, hook strength, viral triggers, format breakdown, variation ideas, suggested hook/hashtags. Includes inline thumbnails. |
|
|
@@ -65,7 +65,7 @@ Every tool that returns posts also renders **inline thumbnails** directly in the
|
|
|
65
65
|
- `discover_social_posts` / `get_user_posts` / `analyze_creator_profile` — each returned post shows its thumbnail inline (up to 4 at once) together with its title/caption + views/likes/comments. Say **"next"** or **"show more"** — Claude will re-call with `offset`/`limit` pagination. Say **"analyze the 2nd one"** — Claude calls `analyze_post` or `understand_social_post` on that URL.
|
|
66
66
|
- **Batch analysis** — ask "analyze all 4" or "understand these 3 in batch" and Claude will call `analyze_post`/`understand_social_post` once per URL in parallel and summarize. For large batches, `discover_social_posts` + a follow-up `analyze_post` per URL is the recommended flow.
|
|
67
67
|
|
|
68
|
-
> The backend's `analyze_post` now watches the **actual video/images** (direct MP4, YouTube `fileUri`, or 6 carousel frames via
|
|
68
|
+
> The backend's `analyze_post` now watches the **actual video/images** (direct MP4, YouTube `fileUri`, or 6 carousel frames via AI multimodal) — not just the caption. The analysis includes a `whatHappens` field describing exactly what is seen.
|
|
69
69
|
|
|
70
70
|
## Prerequisites
|
|
71
71
|
|
package/dist/shared/tools-def.js
CHANGED
|
@@ -15,43 +15,43 @@ export const TOOL_DEFINITIONS = [
|
|
|
15
15
|
{
|
|
16
16
|
name: "discover_social_posts",
|
|
17
17
|
title: "Discover Social Posts",
|
|
18
|
-
description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili
|
|
18
|
+
description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili. Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. Say \"next\" to paginate (offset), or \"analyze the 2nd one\" / \"analyze all\" for batch analysis. Consumes 2 orchyn credits. First use free per user.",
|
|
19
19
|
inputSchema: z.object({ niche: z.string().describe("Niche/topic, e.g. 'fitness'."), keywords: z.string().optional().describe("Optional extra keywords."), limit: z.number().int().optional().describe("Max results (default 6)."), offset: z.number().int().optional().describe("Skip first N results — for 'next' pagination."), platform: z.enum(["youtube", "tiktok", "instagram", "douyin", "xiaohongshu", "twitter", "bilibili", "any"]).optional().describe("Platform to search (default youtube).") }).strict(),
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
name: "get_user_posts",
|
|
23
23
|
title: "Get User Posts",
|
|
24
|
-
description: "List recent posts by a creator handle (e.g. @zoundsapp)
|
|
24
|
+
description: "List recent posts by a creator handle (e.g. @zoundsapp) on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili. Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. Use this when Claude needs to pull more posts from the same account to spot a pattern, or to scan a whole profile. Consumes 2 orchyn credits. First use free per user.",
|
|
25
25
|
inputSchema: z.object({ username: z.string().describe("Creator handle, e.g. 'zoundsapp' or '@zoundsapp'."), platform: z.enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"]).optional().describe("Which platform (default tiktok)."), limit: z.number().int().optional().describe("Max posts (default 6).") }).strict(),
|
|
26
26
|
},
|
|
27
27
|
{
|
|
28
28
|
name: "analyze_creator_profile",
|
|
29
29
|
title: "Analyze Creator Profile",
|
|
30
|
-
description: "Deep-dive a whole creator profile
|
|
30
|
+
description: "Deep-dive a whole creator profile on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetch recent posts, run multimodal AI on up to 3, then synthesize a profile report — creator summary, niche, content themes, hook styles, strengths/weaknesses, engagement patterns, audience insights, variation ideas, collaboration fit. Consumes 15 orchyn credits. First use free per user.",
|
|
31
31
|
inputSchema: z.object({ username: z.string().describe("Creator handle, e.g. 'zoundsapp'."), platform: z.enum(["tiktok", "instagram", "youtube", "douyin", "xiaohongshu", "twitter", "bilibili"]).optional().describe("Which platform (default tiktok)."), limit: z.number().int().optional().describe("Posts to fetch (default 6; first 3 analyzed)."), focus: z.string().optional().describe("Extra instruction for the profile synthesis.") }).strict(),
|
|
32
32
|
},
|
|
33
33
|
{
|
|
34
34
|
name: "get_post_comments",
|
|
35
35
|
title: "Get Post Comments",
|
|
36
|
-
description: "Fetch top comments for a post URL
|
|
36
|
+
description: "Fetch top comments for a post URL on TikTok, Instagram, YouTube, Douyin, X/Twitter or Bilibili (plus keyword clusters from TikTok Analytics when available) — audience sentiment/audience-signal analysis. Consumes 2 orchyn credits. First use free per user.",
|
|
37
37
|
inputSchema: z.object({ url: z.string().describe("Full public post URL (TikTok/Instagram/YouTube/Douyin/X/Bilibili)."), limit: z.number().int().optional().describe("Max comments (default 20).") }).strict(),
|
|
38
38
|
},
|
|
39
39
|
{
|
|
40
40
|
name: "search_creators",
|
|
41
41
|
title: "Search Creators",
|
|
42
|
-
description: "Search creators by niche/keyword
|
|
42
|
+
description: "Search creators by niche/keyword on TikTok, Instagram, Xiaohongshu, YouTube or Douyin — username, nickname, follower count, signature, verified status. Use to find influencers to vet or analyze. Consumes 2 orchyn credits. First use free per user.",
|
|
43
43
|
inputSchema: z.object({ keyword: z.string().describe("Niche/keyword, e.g. 'fitness' or a creator name."), platform: z.enum(["tiktok", "instagram", "xiaohongshu", "youtube", "douyin"]).optional().describe("Which platform (default tiktok)."), count: z.number().int().optional().describe("Max creators (default 8).") }).strict(),
|
|
44
44
|
},
|
|
45
45
|
{
|
|
46
46
|
name: "get_similar_creators",
|
|
47
47
|
title: "Get Similar Creators",
|
|
48
|
-
description: "Find lookalike creators for a given handle
|
|
48
|
+
description: "Find lookalike creators for a given handle — TikTok similar-user recommendations or Instagram similar users. Useful for scaling: 'if this creator works, here are more like them'. Consumes 2 orchyn credits. First use free per user.",
|
|
49
49
|
inputSchema: z.object({ username: z.string().describe("Seed creator handle, e.g. 'zoundsapp'."), platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok).") }).strict(),
|
|
50
50
|
},
|
|
51
51
|
{
|
|
52
52
|
name: "discover_sounds",
|
|
53
53
|
title: "Discover Sounds",
|
|
54
|
-
description: "Discover trending sounds/music for a keyword on TikTok or Instagram
|
|
54
|
+
description: "Discover trending sounds/music for a keyword on TikTok or Instagram — the sound is a huge ranking signal for TikTok virality. Returns title, artist, duration, play/cover URLs. Consumes 2 orchyn credits. First use free per user.",
|
|
55
55
|
inputSchema: z.object({ keyword: z.string().describe("Niche/keyword, e.g. 'gym'."), platform: z.enum(["tiktok", "instagram"]).optional().describe("Which platform (default tiktok)."), count: z.number().int().optional().describe("Max sounds (default 6).") }).strict(),
|
|
56
56
|
},
|
|
57
57
|
{
|
package/dist/shared/tools.js
CHANGED
|
@@ -93,7 +93,7 @@ export function createMcpServer(makeClient) {
|
|
|
93
93
|
});
|
|
94
94
|
server.registerTool("discover_social_posts", {
|
|
95
95
|
title: "Discover Social Posts",
|
|
96
|
-
description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili
|
|
96
|
+
description: "Discover recent posts (video, image, carousel, slideshow) for a niche on YouTube, TikTok, Instagram, Douyin, Xiaohongshu, X/Twitter or Bilibili. " +
|
|
97
97
|
"Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. " +
|
|
98
98
|
'Say "next" to paginate (offset), or "analyze the 2nd one" / "analyze all" for batch analysis. Consumes 2 orchyn credits. First use free per user.',
|
|
99
99
|
inputSchema: z
|
|
@@ -119,7 +119,7 @@ export function createMcpServer(makeClient) {
|
|
|
119
119
|
});
|
|
120
120
|
server.registerTool("get_user_posts", {
|
|
121
121
|
title: "Get User Posts",
|
|
122
|
-
description: "List recent posts by a creator handle (e.g. @zoundsapp)
|
|
122
|
+
description: "List recent posts by a creator handle (e.g. @zoundsapp) on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili. " +
|
|
123
123
|
"Each post includes title/caption, thumbnailUrl, externalUrl, views/likes/comments and inline thumbnails (up to 4) so they show in chat. " +
|
|
124
124
|
"Use this when Claude needs to pull more posts from the same account to spot a pattern, or to scan a whole profile. Consumes 2 orchyn credits. First use free per user.",
|
|
125
125
|
inputSchema: z
|
|
@@ -143,7 +143,7 @@ export function createMcpServer(makeClient) {
|
|
|
143
143
|
});
|
|
144
144
|
server.registerTool("analyze_creator_profile", {
|
|
145
145
|
title: "Analyze Creator Profile",
|
|
146
|
-
description: "Deep-dive a whole creator profile
|
|
146
|
+
description: "Deep-dive a whole creator profile on TikTok, Instagram, YouTube, Douyin, Xiaohongshu, X/Twitter or Bilibili: fetch recent posts, run multimodal AI on up to 3, " +
|
|
147
147
|
"then synthesize a profile report — creator summary, niche, content themes, hook styles, strengths/weaknesses, " +
|
|
148
148
|
"engagement patterns, audience insights, variation ideas, collaboration fit. Consumes 15 orchyn credits. First use free per user.",
|
|
149
149
|
inputSchema: z
|
|
@@ -168,7 +168,7 @@ export function createMcpServer(makeClient) {
|
|
|
168
168
|
});
|
|
169
169
|
server.registerTool("get_post_comments", {
|
|
170
170
|
title: "Get Post Comments",
|
|
171
|
-
description: "Fetch top comments for a post URL
|
|
171
|
+
description: "Fetch top comments for a post URL on TikTok, Instagram, YouTube, Douyin, X/Twitter or Bilibili, plus keyword clusters from TikTok Analytics " +
|
|
172
172
|
"when available — audience sentiment/audience-signal analysis. Consumes 2 orchyn credits. First use free per user.",
|
|
173
173
|
inputSchema: z
|
|
174
174
|
.object({
|
|
@@ -187,7 +187,7 @@ export function createMcpServer(makeClient) {
|
|
|
187
187
|
});
|
|
188
188
|
server.registerTool("search_creators", {
|
|
189
189
|
title: "Search Creators",
|
|
190
|
-
description: "Search creators by niche/keyword
|
|
190
|
+
description: "Search creators by niche/keyword on TikTok, Instagram, Xiaohongshu, YouTube or Douyin — username, nickname, follower count, " +
|
|
191
191
|
"signature, verified status. Use to find influencers to vet or analyze. Consumes 2 orchyn credits. First use free per user.",
|
|
192
192
|
inputSchema: z
|
|
193
193
|
.object({
|
|
@@ -210,7 +210,7 @@ export function createMcpServer(makeClient) {
|
|
|
210
210
|
});
|
|
211
211
|
server.registerTool("get_similar_creators", {
|
|
212
212
|
title: "Get Similar Creators",
|
|
213
|
-
description: "Find lookalike creators for a given handle
|
|
213
|
+
description: "Find lookalike creators for a given handle — TikTok similar-user recommendations or Instagram " +
|
|
214
214
|
"similar users. Useful for scaling: 'if this creator works, here are more like them'. Consumes 2 orchyn credits. First use free per user.",
|
|
215
215
|
inputSchema: z
|
|
216
216
|
.object({
|
|
@@ -229,7 +229,7 @@ export function createMcpServer(makeClient) {
|
|
|
229
229
|
});
|
|
230
230
|
server.registerTool("discover_sounds", {
|
|
231
231
|
title: "Discover Sounds",
|
|
232
|
-
description: "Discover trending sounds/music for a keyword on TikTok or Instagram
|
|
232
|
+
description: "Discover trending sounds/music for a keyword on TikTok or Instagram — the sound is a huge ranking " +
|
|
233
233
|
"signal for TikTok virality. Returns title, artist, duration, play/cover URLs. Consumes 2 orchyn credits. First use free per user.",
|
|
234
234
|
inputSchema: z
|
|
235
235
|
.object({
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@orchyn/mcp",
|
|
3
|
-
"version": "1.7.
|
|
3
|
+
"version": "1.7.3",
|
|
4
4
|
"description": "MCP server for orchyn - fetch, discover and understand TikTok/Instagram/YouTube/X posts with AI (media metadata, niche discovery, hook & viral analysis)",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|