@houtini/fanout-mcp 0.2.0 → 0.2.2

package/README.md

@@ -73,29 +73,21 @@ Plus detailed markdown report with all data.
 ## Installation
 
 ### Prerequisites
-- Node.js 18+
 - Claude Desktop (or any MCP-compatible client)
 - Anthropic API key
+- Node.js 18+ (for local build only)
 
-### Setup
+### Quick Setup (Recommended)
 
-1. **Clone and build:**
-```bash
-git clone https://github.com/houtiniai/fanout-mcp.git
-cd fanout-mcp
-npm install
-npm run build
-```
-
-2. **Configure Claude Desktop:**
+**The fastest way to get started** - no cloning or building required:
 
-Add to `claude_desktop_config.json`:
+1. **Add to `claude_desktop_config.json`:**
 ```json
 {
   "mcpServers": {
     "fanout": {
-      "command": "node",
-      "args": ["/absolute/path/to/fanout-mcp/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "@houtini/fanout-mcp@latest"],
       "env": {
         "ANTHROPIC_API_KEY": "sk-ant-api03-your-key-here"
       }
@@ -197,7 +189,7 @@ This tool implements techniques from cutting-edge Information Retrieval research
 **Query Decomposition** - Least-to-Most prompting breaks complex topics into prerequisite, core, and follow-up queries.
 
 **Want to understand the research?** 📖 Read our accessible explainer:
-### **[Understanding Keyword Fan-Out: The Research Explained](research/keyword-fanout-explained.md)**
+### **[Understanding Keyword Fan-Out: The Research Explained](https://github.com/houtini-ai/fanout-mcp/blob/main/research/keyword-fanout-explained.md)**
 
 This document explains:
 - Why query fan-out matters for content optimization
@@ -206,7 +198,7 @@ This document explains:
 - Real examples from testing
 - When to use which variant types
 
-For implementation details, see [`research/google-fanout-adaptation.md`](research/google-fanout-adaptation.md).
+For implementation details, see [`research/google-fanout-adaptation.md`](https://github.com/houtini-ai/fanout-mcp/blob/main/research/google-fanout-adaptation.md).
 
 ---
 
@@ -615,7 +607,7 @@ For commercial licensing enquiries, please visit https://houtini.com
 
 **Richard Baxter**  
 Houtini.ai  
-GitHub: https://github.com/houtiniai
+GitHub: https://github.com/houtini-ai
 
 **Questions?** Open an issue on GitHub  
 **Commercial enquiries:** https://houtini.com

package/dist/tools/analyze-content-gap.js

@@ -197,15 +197,20 @@ const Badge = ({ children, variant = 'default' }) => {
 const Progress = ({ value }) => <div className="relative h-4 w-full rounded-full bg-secondary"><div className="h-full bg-primary" style={{ width: \`\${value}%\` }} /></div>;
 \`\`\`
 `;
-    const baseInstruction = `[INSTRUCTION TO CLAUDE: Create an interactive React artifact.
+    const baseInstruction = `═══════════════════════════════════════════════════════════════
+CRITICAL INSTRUCTION - ARTIFACT REQUIRED
+═══════════════════════════════════════════════════════════════
+
+YOU MUST CREATE AN INTERACTIVE REACT ARTIFACT FOR THIS ANALYSIS.
+DO NOT provide a text summary. DO NOT explain the data in prose.
+IMMEDIATELY create the artifact using the specifications below.
 
 ${componentTemplates}
 
 `;
     if (isHybridMode) {
         return (baseInstruction +
-            ` 
-
+            `
 **HYBRID ANALYSIS MODE DETECTED**
 
 This analysis combines content-based query inference with keyword fan-out variants. 
@@ -224,14 +229,19 @@ STRUCTURE:
 LAYOUT: min-h-screen bg-background p-6, max-w-6xl mx-auto, use Card components
 DATA: Show ALL queries, NO placeholder text like "+ 3 more items"
 
-Make visually appealing with semantic HTML and accessibility.]
+REMINDER: This MUST be a React artifact, not a text response.
+
+═══════════════════════════════════════════════════════════════
+END CRITICAL INSTRUCTION
+═══════════════════════════════════════════════════════════════
 
 ---
 
 `);
     }
     return (baseInstruction +
-        `STRUCTURE:
+        `
+STRUCTURE:
 1. Header (gradient) - Title, URL, Progress bar, stats
 2. Query Sections (Collapsible) - Prerequisite (blue), Core (purple), Follow-up (orange)
 3. Summary Recommendations - High/medium priority
@@ -240,7 +250,11 @@ Make visually appealing with semantic HTML and accessibility.]
 LAYOUT: min-h-screen bg-background p-6, max-w-5xl mx-auto
 DATA: Show ALL queries, NO placeholder text or truncation
 
-Make visually appealing with semantic HTML and accessibility.]
+REMINDER: This MUST be a React artifact, not a text response.
+
+═══════════════════════════════════════════════════════════════
+END CRITICAL INSTRUCTION
+═══════════════════════════════════════════════════════════════
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houtini/fanout-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Advanced content gap analysis using Query Decomposition, Keyword Fan-Out, and Self-RAG for Generative Engine Optimization (GEO)",
   "type": "module",
   "main": "dist/index.js",
@@ -33,11 +33,11 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/houtiniai/fanout-mcp.git"
+    "url": "git+https://github.com/houtini-ai/fanout-mcp.git"
   },
-  "homepage": "https://github.com/houtiniai/fanout-mcp#readme",
+  "homepage": "https://houtini.com",
   "bugs": {
-    "url": "https://github.com/houtiniai/fanout-mcp/issues"
+    "url": "https://github.com/houtini-ai/fanout-mcp/issues"
   },
   "engines": {
     "node": ">=18.0.0"