@kood/claude-code 0.6.5 → 0.6.7

package/dist/index.js

@@ -23,6 +23,7 @@ var banner = () => {
 
 // src/commands/init.ts
 import fs8 from "fs-extra";
+import os from "os";
 
 // src/features/templates/template-path-resolver.ts
 import path2 from "path";
@@ -117,6 +118,11 @@ var templateMetadata = {
     name: "NPX CLI",
     description: "NPX\uB85C \uC2E4\uD589 \uAC00\uB2A5\uD55C CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8",
     stack: "Node.js, TypeScript, Commander.js"
+  },
+  tauri: {
+    name: "Tauri",
+    description: "Cross-platform Desktop & Mobile \uC571 \uD504\uB85C\uC81D\uD2B8",
+    stack: "Rust, React, TypeScript, Vite"
   }
 };
 var generateIndexClaudeMd = (templates) => {
@@ -319,6 +325,7 @@ var createExtrasCopier = (extrasType) => {
 var copyCommands = createExtrasCopier("commands");
 var copyAgents = createExtrasCopier("agents");
 var copyInstructions = createExtrasCopier("instructions");
+var copyScripts = createExtrasCopier("scripts");
 var getSkillsToInstall = async (skillsSrc, templates) => {
   const metadataMap = await loadAllSkillMetadata(skillsSrc);
   const isNonUITemplate = templates.some((t) => NON_UI_TEMPLATES.includes(t));
@@ -363,6 +370,7 @@ var checkExistingClaudeFiles = async (targetDir) => {
   const commandsDir = path8.join(targetDir, ".claude", "commands");
   const agentsDir = path8.join(targetDir, ".claude", "agents");
   const instructionsDir = path8.join(targetDir, ".claude", "instructions");
+  const scriptsDir = path8.join(targetDir, ".claude", "scripts");
   if (await fs6.pathExists(skillsDir)) {
     existingFiles.push(".claude/skills/");
   }
@@ -375,6 +383,9 @@ var checkExistingClaudeFiles = async (targetDir) => {
   if (await fs6.pathExists(instructionsDir)) {
     existingFiles.push(".claude/instructions/");
   }
+  if (await fs6.pathExists(scriptsDir)) {
+    existingFiles.push(".claude/scripts/");
+  }
   return existingFiles;
 };
 var checkAllExtrasExist = async (_templates) => {
@@ -383,13 +394,150 @@ var checkAllExtrasExist = async (_templates) => {
   const commandsSrc = path8.join(claudeDir, "commands");
   const agentsSrc = path8.join(claudeDir, "agents");
   const instructionsSrc = path8.join(claudeDir, "instructions");
+  const scriptsSrc = path8.join(claudeDir, "scripts");
   const hasSkills = await hasFiles(skillsSrc);
   const hasCommands = await hasFiles(commandsSrc);
   const hasAgents = await hasFiles(agentsSrc);
   const hasInstructions = await hasFiles(instructionsSrc);
-  return { hasSkills, hasCommands, hasAgents, hasInstructions };
+  const hasScripts = await hasFiles(scriptsSrc);
+  return { hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts };
 };
 
+// src/features/extras/extras-installer.ts
+function logExistingFilesUpdate(existingClaudeFiles) {
+  if (existingClaudeFiles.length > 0) {
+    logger.info("Updating existing extras:");
+    existingClaudeFiles.forEach((f) => logger.step(f));
+  }
+}
+async function installSkillsIfNeeded(templates, targetDir, shouldInstall, hasSkills) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasSkills) {
+    logger.warn("No skills found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing skills...");
+  const skillsResult = await copySkills(templates, targetDir);
+  logger.success(
+    `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
+  );
+  return skillsResult;
+}
+async function installCommandsIfNeeded(templates, targetDir, shouldInstall, hasCommands) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasCommands) {
+    logger.warn("No commands found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing commands...");
+  const commandsResult = await copyCommands(templates, targetDir);
+  logger.success(
+    `Commands: ${commandsResult.files} files, ${commandsResult.directories} directories`
+  );
+  return commandsResult;
+}
+async function installAgentsIfNeeded(templates, targetDir, shouldInstall, hasAgents) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasAgents) {
+    logger.warn("No agents found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing agents...");
+  const agentsResult = await copyAgents(templates, targetDir);
+  logger.success(
+    `Agents: ${agentsResult.files} files, ${agentsResult.directories} directories`
+  );
+  return agentsResult;
+}
+async function installScriptsIfNeeded(templates, targetDir, shouldInstall, hasScripts) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasScripts) {
+    logger.warn("No scripts found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing scripts...");
+  const scriptsResult = await copyScripts(templates, targetDir);
+  logger.success(
+    `Scripts: ${scriptsResult.files} files, ${scriptsResult.directories} directories`
+  );
+  return scriptsResult;
+}
+async function installInstructionsIfNeeded(templates, targetDir, shouldInstall, hasInstructions) {
+  if (!shouldInstall) {
+    return { files: 0, directories: 0 };
+  }
+  if (!hasInstructions) {
+    logger.warn("No instructions found in selected templates.");
+    return { files: 0, directories: 0 };
+  }
+  logger.blank();
+  logger.info("Installing instructions...");
+  const instructionsResult = await copyInstructions(templates, targetDir);
+  logger.success(
+    `Instructions: ${instructionsResult.files} files, ${instructionsResult.directories} directories`
+  );
+  return instructionsResult;
+}
+async function installExtras(templates, targetDir, flags, availability) {
+  const {
+    installSkills,
+    installCommands,
+    installAgents,
+    installInstructions,
+    installScripts
+  } = flags;
+  if (!installSkills && !installCommands && !installAgents && !installInstructions && !installScripts) {
+    return { files: 0, directories: 0 };
+  }
+  const existingClaudeFiles = await checkExistingClaudeFiles(targetDir);
+  logExistingFilesUpdate(existingClaudeFiles);
+  const skillsResult = await installSkillsIfNeeded(
+    templates,
+    targetDir,
+    installSkills,
+    availability.hasSkills
+  );
+  const commandsResult = await installCommandsIfNeeded(
+    templates,
+    targetDir,
+    installCommands,
+    availability.hasCommands
+  );
+  const agentsResult = await installAgentsIfNeeded(
+    templates,
+    targetDir,
+    installAgents,
+    availability.hasAgents
+  );
+  const instructionsResult = await installInstructionsIfNeeded(
+    templates,
+    targetDir,
+    installInstructions,
+    availability.hasInstructions
+  );
+  const scriptsResult = await installScriptsIfNeeded(
+    templates,
+    targetDir,
+    installScripts,
+    availability.hasScripts
+  );
+  const totalFiles = skillsResult.files + commandsResult.files + agentsResult.files + instructionsResult.files + scriptsResult.files;
+  const totalDirectories = skillsResult.directories + commandsResult.directories + agentsResult.directories + instructionsResult.directories + scriptsResult.directories;
+  return { files: totalFiles, directories: totalDirectories };
+}
+
 // src/shared/prompts/prompt-helpers.ts
 import prompts from "prompts";
 async function promptConfirm(message, initial = false) {
@@ -401,6 +549,15 @@ async function promptConfirm(message, initial = false) {
   });
   return { confirmed: response.confirmed ?? false };
 }
+async function promptSelect(message, choices) {
+  const response = await prompts({
+    type: "select",
+    name: "value",
+    message,
+    choices
+  });
+  return { value: response.value };
+}
 async function promptMultiselect(message, choices, options) {
   const response = await prompts({
     type: "multiselect",
@@ -461,17 +618,20 @@ async function promptExtrasSelection(options) {
     commands,
     agents,
     instructions,
+    scripts,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts
   } = options;
   let installSkills = skills ?? false;
   let installCommands = commands ?? false;
   const installAgents = agents ?? hasAgents;
   const installInstructions = instructions ?? hasInstructions;
-  const noOptionsProvided = skills === void 0 && commands === void 0 && agents === void 0 && instructions === void 0;
-  if (noOptionsProvided && (hasSkills || hasCommands || hasAgents || hasInstructions)) {
+  const installScripts = scripts ?? hasScripts;
+  const noOptionsProvided = skills === void 0 && commands === void 0 && agents === void 0 && instructions === void 0 && scripts === void 0;
+  if (noOptionsProvided && (hasSkills || hasCommands || hasAgents || hasInstructions || hasScripts)) {
     logger.blank();
     if (hasSkills) {
       const result = await promptConfirm(
@@ -492,126 +652,41 @@ async function promptExtrasSelection(options) {
     installSkills,
     installCommands,
     installAgents,
-    installInstructions
+    installInstructions,
+    installScripts
   };
 }
-
-// src/features/extras/extras-installer.ts
-async function handleDuplicateFiles(existingClaudeFiles, force) {
-  if (existingClaudeFiles.length === 0 || force) {
-    return true;
-  }
-  logger.warn("The following .claude files/folders already exist:");
-  existingClaudeFiles.forEach((f) => logger.step(f));
-  logger.blank();
-  const response = await promptConfirm(
-    "Overwrite existing .claude files?",
-    false
-  );
-  return response.confirmed;
-}
-async function installSkillsIfNeeded(templates, targetDir, shouldInstall, hasSkills) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasSkills) {
-    logger.warn("No skills found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing skills...");
-  const skillsResult = await copySkills(templates, targetDir);
-  logger.success(
-    `Skills: ${skillsResult.files} files, ${skillsResult.directories} directories`
-  );
-  return skillsResult;
-}
-async function installCommandsIfNeeded(templates, targetDir, shouldInstall, hasCommands) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasCommands) {
-    logger.warn("No commands found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing commands...");
-  const commandsResult = await copyCommands(templates, targetDir);
-  logger.success(
-    `Commands: ${commandsResult.files} files, ${commandsResult.directories} directories`
-  );
-  return commandsResult;
-}
-async function installAgentsIfNeeded(templates, targetDir, shouldInstall, hasAgents) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasAgents) {
-    logger.warn("No agents found in selected templates.");
-    return { files: 0, directories: 0 };
-  }
-  logger.blank();
-  logger.info("Installing agents...");
-  const agentsResult = await copyAgents(templates, targetDir);
-  logger.success(
-    `Agents: ${agentsResult.files} files, ${agentsResult.directories} directories`
-  );
-  return agentsResult;
-}
-async function installInstructionsIfNeeded(templates, targetDir, shouldInstall, hasInstructions) {
-  if (!shouldInstall) {
-    return { files: 0, directories: 0 };
-  }
-  if (!hasInstructions) {
-    logger.warn("No instructions found in selected templates.");
-    return { files: 0, directories: 0 };
+async function promptScopeSelection(options) {
+  const { providedScope } = options;
+  if (providedScope) {
+    if (providedScope !== "project" && providedScope !== "user") {
+      logger.error(
+        `Invalid scope: "${providedScope}". Use "project" or "user".`
+      );
+      process.exit(1);
+    }
+    return { scope: providedScope };
   }
-  logger.blank();
-  logger.info("Installing instructions...");
-  const instructionsResult = await copyInstructions(templates, targetDir);
-  logger.success(
-    `Instructions: ${instructionsResult.files} files, ${instructionsResult.directories} directories`
+  const response = await promptSelect(
+    "Select installation scope:",
+    [
+      {
+        title: "Project",
+        description: "Install to current project (.claude/)",
+        value: "project"
+      },
+      {
+        title: "User",
+        description: "Install to user home (~/.claude/)",
+        value: "user"
+      }
+    ]
   );
-  return instructionsResult;
-}
-async function installExtras(templates, targetDir, flags, availability, force) {
-  const { installSkills, installCommands, installAgents, installInstructions } = flags;
-  if (!installSkills && !installCommands && !installAgents && !installInstructions) {
-    return { files: 0, directories: 0 };
-  }
-  const existingClaudeFiles = await checkExistingClaudeFiles(targetDir);
-  const shouldProceed = await handleDuplicateFiles(existingClaudeFiles, force);
-  if (!shouldProceed) {
-    logger.info("Skipping extras installation.");
-    return { files: 0, directories: 0 };
+  if (!response.value) {
+    logger.info("Operation cancelled.");
+    process.exit(0);
   }
-  const skillsResult = await installSkillsIfNeeded(
-    templates,
-    targetDir,
-    installSkills,
-    availability.hasSkills
-  );
-  const commandsResult = await installCommandsIfNeeded(
-    templates,
-    targetDir,
-    installCommands,
-    availability.hasCommands
-  );
-  const agentsResult = await installAgentsIfNeeded(
-    templates,
-    targetDir,
-    installAgents,
-    availability.hasAgents
-  );
-  const instructionsResult = await installInstructionsIfNeeded(
-    templates,
-    targetDir,
-    installInstructions,
-    availability.hasInstructions
-  );
-  const totalFiles = skillsResult.files + commandsResult.files + agentsResult.files + instructionsResult.files;
-  const totalDirectories = skillsResult.directories + commandsResult.directories + agentsResult.directories + instructionsResult.directories;
-  return { files: totalFiles, directories: totalDirectories };
+  return { scope: response.value };
 }
 
 // src/shared/gitignore-manager.ts
@@ -684,7 +759,8 @@ async function updateGitignore(targetDir) {
 var TEMPLATE_DESCRIPTIONS = {
   "tanstack-start": "TanStack Start + React \uD480\uC2A4\uD0DD \uD504\uB85C\uC81D\uD2B8",
   hono: "Hono \uC11C\uBC84 \uD504\uB808\uC784\uC6CC\uD06C \uD504\uB85C\uC81D\uD2B8",
-  npx: "NPX CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8"
+  npx: "NPX CLI \uB3C4\uAD6C \uD504\uB85C\uC81D\uD2B8",
+  tauri: "Tauri \uB370\uC2A4\uD06C\uD1B1/\uBAA8\uBC14\uC77C \uD06C\uB85C\uC2A4\uD50C\uB7AB\uD3FC \uC571"
 };
 async function validateTargetDirectory(targetDir) {
   try {
@@ -756,29 +832,38 @@ async function installTemplates(templates, targetDir) {
   logger.success(`Total: ${totalFiles} files, ${totalDirectories} directories`);
   return { files: totalFiles, directories: totalDirectories };
 }
-async function promptForExtrasInstallation(options, hasSkills, hasCommands, hasAgents, hasInstructions) {
+async function promptForExtrasInstallation(options, hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts) {
   return await promptExtrasSelection({
     skills: options.skills,
     commands: options.commands,
     agents: options.agents,
     instructions: options.instructions,
+    scripts: options.scripts,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts
   });
 }
-function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAgents, hasInstructions) {
-  const { installSkills, installCommands, installAgents, installInstructions } = flags;
-  const hasExtrasInstalled = installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions;
+function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts, scope) {
+  const {
+    installSkills,
+    installCommands,
+    installAgents,
+    installInstructions,
+    installScripts
+  } = flags;
+  const hasExtrasInstalled = installSkills && hasSkills || installCommands && hasCommands || installAgents && hasAgents || installInstructions && hasInstructions || installScripts && hasScripts;
   if (templates.length === 0 && !hasExtrasInstalled) {
     logger.blank();
     logger.info("No templates or extras installed.");
     logger.blank();
     return;
   }
+  const scopeLabel = scope === "user" ? "(user scope \u2192 ~/.claude/)" : "(project scope)";
   logger.blank();
-  logger.success("Claude Code documentation installed!");
+  logger.success(`Claude Code documentation installed! ${scopeLabel}`);
   if (templates.length > 0) {
     logger.blank();
     logger.info("Installed templates:");
@@ -799,6 +884,9 @@ function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAg
     if (installInstructions && hasInstructions) {
       logger.step("Instructions \u2192 .claude/instructions/");
     }
+    if (installScripts && hasScripts) {
+      logger.step("Scripts \u2192 .claude/scripts/");
+    }
   }
   logger.blank();
   logger.info("Next steps:");
@@ -812,48 +900,65 @@ function showInstallationSummary(templates, flags, hasSkills, hasCommands, hasAg
   logger.blank();
 }
 var init = async (options) => {
-  const targetDir = options.cwd || process.cwd();
-  await validateTargetDirectory(targetDir);
+  const projectDir = options.cwd || process.cwd();
+  await validateTargetDirectory(projectDir);
+  const { scope } = await promptScopeSelection({
+    providedScope: options.scope
+  });
+  const targetDir = scope === "user" ? os.homedir() : projectDir;
+  const isUserScope = scope === "user";
+  if (isUserScope) {
+    logger.blank();
+    logger.info(`Installing to ~/.claude/ (user scope)`);
+  }
   const availableTemplates = await listAvailableTemplates();
   if (availableTemplates.length === 0) {
     logger.error("No templates found. Package may be corrupted.");
     process.exit(1);
   }
-  const templates = await selectTemplates(options, availableTemplates);
-  if (templates.length > 0) {
-    await confirmOverwriteIfNeeded(targetDir, options.force ?? false);
-    await installTemplates(templates, targetDir);
+  let templates = [];
+  if (!isUserScope) {
+    templates = await selectTemplates(options, availableTemplates);
+    if (templates.length > 0) {
+      await confirmOverwriteIfNeeded(targetDir, options.force ?? false);
+      await installTemplates(templates, targetDir);
+    }
   }
   const templatesToCheck = templates.length > 0 ? templates : availableTemplates;
-  const { hasSkills, hasCommands, hasAgents, hasInstructions } = await checkAllExtrasExist(templatesToCheck);
+  const { hasSkills, hasCommands, hasAgents, hasInstructions, hasScripts } = await checkAllExtrasExist(templatesToCheck);
   const flags = await promptForExtrasInstallation(
     options,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
-  );
-  await installExtras(
-    templatesToCheck,
-    targetDir,
-    flags,
-    { hasSkills, hasCommands, hasAgents, hasInstructions },
-    options.force ?? false
+    hasInstructions,
+    hasScripts
   );
+  await installExtras(templatesToCheck, targetDir, flags, {
+    hasSkills,
+    hasCommands,
+    hasAgents,
+    hasInstructions,
+    hasScripts
+  });
   showInstallationSummary(
     templates,
     flags,
     hasSkills,
     hasCommands,
     hasAgents,
-    hasInstructions
+    hasInstructions,
+    hasScripts,
+    scope
   );
-  try {
-    await updateGitignore(targetDir);
-  } catch (error) {
-    logger.warn(
-      `Failed to update .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`
-    );
+  if (!isUserScope) {
+    try {
+      await updateGitignore(targetDir);
+    } catch (error) {
+      logger.warn(
+        `Failed to update .gitignore: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
   }
 };
 
@@ -863,7 +968,7 @@ program.name("claude-code").description("Claude Code documentation installer for
 program.option(
   "-t, --template <names>",
   "template names (comma-separated: tanstack-start,hono)"
-).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").action(async (options) => {
+).option("-f, --force", "overwrite existing files without prompting").option("--cwd <path>", "target directory (default: current directory)").option("--list", "list available templates").option("-s, --skills", "install skills to .claude/skills/").option("-c, --commands", "install commands to .claude/commands/").option("-a, --agents", "install agents to .claude/agents/").option("--scope <scope>", "installation scope (project|user)").action(async (options) => {
   banner();
   if (options.list) {
     const templates = await listAvailableTemplates();
@@ -876,6 +981,7 @@ program.option(
     templates: options.template?.split(",").map((t) => t.trim()),
     force: options.force,
     cwd: options.cwd,
+    scope: options.scope,
     skills: options.skills,
     commands: options.commands,
     agents: options.agents

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/agents/researcher.md

@@ -61,7 +61,7 @@ permissionMode: default
 |------|------|------|
 | **1. 분석** | 질문 분해, 키워드 추출, 버전 확인 | - |
 | **2. 검색** | 공식 문서 → GitHub → Stack Overflow | WebSearch |
-| **3. 수집** | 관련 페이지 내용 읽기 | WebFetch |
+| **3. 수집** | 관련 페이지 내용 읽기 (JS 렌더링 필요 시 `r.jina.ai` 폴백) | WebFetch |
 | **4. 검증** | 버전 일치 확인, 교차 검증 | - |
 | **5. 종합** | 핵심 요약 + 상세 내용 + 출처 | - |
 
@@ -78,6 +78,13 @@ permissionMode: default
 "[라이브러리명] migration guide v[버전]"
 ```
 
+## Jina Reader (JS 렌더링 / WebFetch 실패 시 폴백)
+```
+WebFetch('https://r.jina.ai/{공식문서URL}', '{추출할 내용}')
+→ JS 렌더링 지원, 광고/네비 제거, 클린 마크다운 변환
+→ WebFetch로 빈 결과 시 Jina Reader 시도
+```
+
 ## GitHub
 ```
 "site:github.com [org]/[repo] [키워드]"

package/templates/.claude/instructions/sourcing/reliable-search.md

@@ -298,6 +298,7 @@ WebSearch({ query: "AI agent frameworks comparison" })
 | **WebSearch** | 연도 포함, 영어+한국어 병렬 |
 | **SearXNG** | `time_range=year` + 연도 키워드 |
 | **Firecrawl** | 공식 문서 URL 직접 지정 |
+| **Jina Reader** | `WebFetch('https://r.jina.ai/{URL}')` — JS 렌더링 클린 MD 변환 |
 | **GitHub** | `created:>YYYY-01-01` 필터, stars 정렬 |
 
 ---
@@ -314,6 +315,7 @@ Tier 1 (MCP, ToolSearch로 감지):
 Tier 2 (내장, 항상 가용):
   WebSearch → 웹 검색 (연도 키워드 필수)
   WebFetch  → 페이지 직접 읽기
+  Jina Reader → WebFetch('https://r.jina.ai/{URL}') 클린 마크다운 변환
   gh CLI    → GitHub API (Bash via explore)
 
 Tier 3: Playwright → SPA/JS 렌더링 필요 시 (crawler skill)
@@ -323,10 +325,10 @@ Tier 3: Playwright → SPA/JS 렌더링 필요 시 (crawler skill)
 
 | MCP 도구 | 용도 | 미설치 시 폴백 |
 |----------|------|--------------|
-| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | WebFetch (페이지별) |
+| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | Jina Reader → WebFetch (페이지별) |
 | SearXNG `web_search` | 246+ 엔진 메타검색 | WebSearch (내장) |
 | `search_repositories/code/issues` | GitHub 리포/코드/이슈 | `gh search` (Bash) |
-| `resolve-library-id` + `query-docs` | 라이브러리 문서 조회 | WebFetch (직접) |
+| `resolve-library-id` + `query-docs` | 라이브러리 문서 조회 | Jina Reader → WebFetch (직접) |
 
 ### MCP 감지 (Phase 0 공통)
 
@@ -339,6 +341,51 @@ ToolSearch("context7")  → Context7 활성화
 
 ---
 
+## Jina Reader (`r.jina.ai`)
+
+**용도:** URL → 클린 마크다운 변환 (JS 렌더링 지원, 광고/네비 제거)
+
+| 특성 | 설명 |
+|------|------|
+| **엔드포인트** | `https://r.jina.ai/{URL}` |
+| **호출 방법** | `WebFetch('https://r.jina.ai/{URL}', '{프롬프트}')` |
+| **장점** | JS 렌더링, 클린 MD, 광고/네비 자동 제거, 무료 |
+| **한계** | 검색 기능 없음 (URL 필수), 대량 크롤링 비적합 |
+
+### 활용 시나리오
+
+| 시나리오 | 사용 |
+|----------|------|
+| **WebFetch 실패** | JS 렌더링 필요 페이지 → Jina Reader 폴백 |
+| **Firecrawl 미설치** | 개별 페이지 클린 MD 변환 |
+| **공식 문서 읽기** | SPA 기반 문서 사이트 (React, Vue 등) |
+| **블로그/미디어** | 광고 제거된 본문만 추출 |
+
+### 사용 패턴
+
+```typescript
+// ✅ 기본: URL을 클린 마크다운으로 변환
+WebFetch('https://r.jina.ai/https://react.dev/reference/react/use', '핵심 API 사용법 추출')
+
+// ✅ WebFetch 실패 시 Jina 폴백
+WebFetch('https://docs.example.com/guide')  // → 빈 결과 (JS 렌더링 필요)
+WebFetch('https://r.jina.ai/https://docs.example.com/guide', '가이드 내용 추출')  // → 클린 MD
+
+// ✅ Firecrawl 미설치 시 개별 페이지 대안
+WebFetch('https://r.jina.ai/https://prisma.io/docs/orm/prisma-schema', 'Prisma 스키마 문법 추출')
+
+// ❌ 검색 용도로 사용 (검색은 WebSearch/SearXNG 사용)
+WebFetch('https://r.jina.ai/react hooks tutorial')  // 잘못된 사용
+```
+
+### 폴백 체인 (페이지 읽기)
+
+```
+Firecrawl scrape → Jina Reader → WebFetch (직접) → Playwright (최후 수단)
+```
+
+---
+
 ## 수집 후 검증
 
 | 단계 | 검증 |