@mkterswingman/5mghost-yonder 0.0.24 → 0.0.26

package/dist/cli/setupCookies.d.ts

@@ -55,6 +55,9 @@ export interface SetupCookiesOptions {
     importOnly?: boolean;
     headed?: boolean;
 }
+export declare class BrowserProfileLockedError extends Error {
+    constructor(message?: string);
+}
 type SetupCookiesChromium = Awaited<ReturnType<SetupCookiesDeps["loadChromium"]>>;
 interface CdpCookie {
     name: string;

package/dist/cli/setupCookies.js

@@ -109,6 +109,12 @@ async function loadPlaywrightChromium() {
     const pw = await import("playwright");
     return pw.chromium;
 }
+export class BrowserProfileLockedError extends Error {
+    constructor(message = "Chrome/Edge profile is locked by a running browser") {
+        super(message);
+        this.name = "BrowserProfileLockedError";
+    }
+}
 function buildSetupCookiesDeps(overrides = {}) {
     return {
         ensureConfigDir,
@@ -194,6 +200,7 @@ async function terminateImportedBrowser(processHandle) {
 }
 export async function tryImportBrowserCookies(chromium, deps) {
     const candidates = deps.findImportableBrowserProfileCandidates();
+    let sawLockedProfile = false;
     if (candidates.length === 0) {
         return false;
     }
@@ -201,7 +208,19 @@ export async function tryImportBrowserCookies(chromium, deps) {
         const candidate = candidates[index];
         const isLastCandidate = index === candidates.length - 1;
         deps.log(`Trying to import existing YouTube login from ${candidate.label} (${candidate.profileLabel})...`);
-        const importedCookies = await deps.readImportedBrowserCookies(candidate, chromium, deps);
+        let importedCookies = null;
+        try {
+            importedCookies = await deps.readImportedBrowserCookies(candidate, chromium, deps);
+        }
+        catch (err) {
+            if (err instanceof BrowserProfileLockedError) {
+                sawLockedProfile = true;
+                deps.log(`${candidate.label} (${candidate.profileLabel}) profile is locked by a running browser.`);
+            }
+            else {
+                throw err;
+            }
+        }
         if (importedCookies) {
             await deps.saveCookiesAndClose({ close: async () => { } }, importedCookies, true);
             deps.log(`✅ Imported YouTube session from ${candidate.label} (${candidate.profileLabel})\n`);
@@ -212,6 +231,9 @@ export async function tryImportBrowserCookies(chromium, deps) {
             deps.log(`${candidate.label} (${candidate.profileLabel}) import unavailable, trying ${nextCandidate.label} (${nextCandidate.profileLabel})...`);
         }
     }
+    if (sawLockedProfile) {
+        throw new BrowserProfileLockedError("Chrome/Edge profile is locked by a running browser. Close Chrome/Edge and rerun `yt-mcp setup-cookies`, or continue with headed browser login.");
+    }
     deps.log("Browser profile import failed, falling back to manual login...\n");
     return false;
 }
@@ -255,7 +277,14 @@ export async function readImportedBrowserCookies(candidate, chromium, deps) {
         }
         return cookies;
     }
-    catch {
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = typeof err === "object" && err && "code" in err ? String(err.code ?? "") : "";
+        if (code === "EBUSY" ||
+            code === "EPERM" ||
+            /resource busy|being used by another process|used by another process|device or resource busy|operation not permitted/i.test(message)) {
+            throw new BrowserProfileLockedError();
+        }
         return null;
     }
     finally {

package/dist/server.d.ts

@@ -10,9 +10,9 @@ import type { DownloadToolDeps } from "./tools/downloads.js";
  *
  *   serve startup
  *     │
- *     ├─ YT_MCP_TOKEN env var? ──▶ PAT mode ──▶ full server (19 tools)
+ *     ├─ YT_MCP_TOKEN env var? ──▶ PAT mode ──▶ full server (20 tools)
  *     │
- *     ├─ auth.json exists? ──▶ JWT mode ──▶ full server (19 tools)
+ *     ├─ auth.json exists? ──▶ JWT mode ──▶ full server (20 tools)
  *     │
  *     └─ no token? ──▶ register "setup_required" tool only
  *           │

package/dist/server.js

@@ -10,9 +10,9 @@ import { registerRemoteTools } from "./tools/remote.js";
  *
  *   serve startup
  *     │
- *     ├─ YT_MCP_TOKEN env var? ──▶ PAT mode ──▶ full server (19 tools)
+ *     ├─ YT_MCP_TOKEN env var? ──▶ PAT mode ──▶ full server (20 tools)
  *     │
- *     ├─ auth.json exists? ──▶ JWT mode ──▶ full server (19 tools)
+ *     ├─ auth.json exists? ──▶ JWT mode ──▶ full server (20 tools)
  *     │
  *     └─ no token? ──▶ register "setup_required" tool only
  *           │

package/dist/tools/remote.js

@@ -134,6 +134,15 @@ const REMOTE_TOOLS = [
         },
         remotePath: "api/trending",
     },
+    {
+        name: "search_channels",
+        description: "Search YouTube channels by keyword for candidate discovery.",
+        schema: {
+            query: z.string().min(1).max(200),
+            max_results: z.number().int().min(1).max(50).optional(),
+        },
+        remotePath: "api/channel/search",
+    },
     {
         name: "get_channel_stats",
         description: "Get YouTube channel statistics for up to 50 channel inputs.",

package/dist/utils/browserProfileImport.js

@@ -93,6 +93,10 @@ export function parseBrowserProfilesFromLocalState(localStateText) {
 function buildProfileLabel(profileName, meta) {
     return meta?.name?.trim() || meta?.user_name?.trim() || meta?.gaia_name?.trim() || profileName;
 }
+function hasReusableCookieStore(profileDir, exists) {
+    // Why: recent Chromium builds often moved the SQLite cookie DB under Network/Cookies.
+    return exists(join(profileDir, "Cookies")) || exists(join(profileDir, "Network", "Cookies"));
+}
 export function findImportableBrowserProfileCandidates(input) {
     const exists = input?.exists ?? existsSync;
     const readFile = input?.readFile ?? ((path) => readFileSync(path, "utf8"));
@@ -114,7 +118,7 @@ export function findImportableBrowserProfileCandidates(input) {
         }
         for (const profileName of parsedState.orderedProfileNames) {
             const profileDir = join(installation.rootDir, profileName);
-            if (!exists(profileDir)) {
+            if (!exists(profileDir) || !hasReusableCookieStore(profileDir, exists)) {
                 continue;
             }
             candidates.push({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mkterswingman/5mghost-yonder",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "description": "Internal MCP client with local data tools and remote API proxy",
   "type": "module",
   "bin": {

package/skills/use-yt-mcp/SKILL.md

@@ -10,14 +10,14 @@ description: |
   Keywords: YouTube, 频道, 视频, 字幕, 评论, 均播, 播放量, trending, yt-mcp, youtube.com, youtu.be.
 ---
 
-# Use yt-mcp
+# use-yt-mcp
 
 Focus on YouTube analysis with yt-mcp MCP tools. Answer the analysis question first. Only switch into setup or troubleshooting when the user explicitly asks for it or a tool call fails.
 
 ## 0. Hard Constraints
 
 - For YouTube data tasks, always use `mcp__yt-mcp__*` tools first.
-- Do not route YouTube queries to legacy MCPs or legacy setup skills such as `youtube-data`, `mcp_youtube_data`, `use-youtube-data-mcp`, or `Use YouTube Data MCP` when `yt-mcp` can answer.
+- Do not route YouTube queries to legacy MCPs or legacy setup skills such as `youtube-data`, `mcp_youtube_data`, or `use-youtube-data-mcp` when `yt-mcp` can answer.
 - Do not fetch YouTube metrics, subtitles, comments, channel data, or trending data by browsing the web, scraping pages, or using generic web search. Use `yt-mcp` instead.
 - If `yt-mcp` is unavailable or fails, stop and tell the user it needs setup or troubleshooting. Do not silently fall back to old MCPs or ad-hoc web lookup.
 
@@ -31,6 +31,8 @@ Focus on YouTube analysis with yt-mcp MCP tools. Answer the analysis question fi
 | User Intent | Tool(s) |
 |---|---|
 | Search videos by keyword | `search_videos` |
+| Name-only creator request without explicit platform | confirm platform first, then `search_channels` |
+| Search channel candidates by fuzzy name | `search_channels` |
 | Get video metrics in bulk | `get_video_stats` |
 | Large video stats job | `start_video_stats_job` -> `poll_video_stats_job` |
 | Get subtitles / transcript | `get_subtitles`, `batch_get_subtitles` |
@@ -48,6 +50,10 @@ All tools are prefixed `mcp__yt-mcp__` in actual calls.
 ## 2. Analysis Rules
 
 - Prefer batch-capable tools when comparing multiple videos or channels.
+- If the user only gives a creator name but does not explicitly say platform, ask first whether they mean a YouTube creator/channel before running yt-mcp tools.
+- If the user provides a fuzzy channel name (for example only a brand/person name), call `search_channels` first and present 3-5 candidates before doing channel analysis.
+- After `search_channels` returns candidates, explicitly ask the user which channel they mean; do not auto-select candidate #1.
+- If the user already provides a channel URL, `@handle`, or explicit `channel_id`, skip candidate search and go directly to `get_channel_stats` / `list_channel_uploads`.
 - `get_video_stats` accepts up to 1000 items. If the response returns `mode: "file"`, then inline `preview_items` is only a preview sample from a larger dataset and must not be used as the full basis of analysis. Tell the user the complete result is in `output_file` or `download_url`.
 - For large video/comment analyses where completeness matters, prefer async jobs: `start_video_stats_job` -> `poll_video_stats_job`, or `start_comments_job` -> `poll_comments_job`.
 - When using async jobs, poll until status is `completed`, and tell the user if the result is still partial or in progress.