@dinerburger/kagi-search-mcp 1.0.0

package/README.md

@@ -0,0 +1,193 @@
+# Kagi Search MCP
+
+A Node.js tool that executes Kagi searches via Kagi's HTML-only endpoint — no official API access and no headless browser required. Suitable for people with a paid Kagi plan for a better web search experience.
+
+Kagi is a privacy-focused, ad-free search engine that delivers high-quality search results. This tool can be used directly as a command-line tool or as a Model Context Protocol (MCP) server to provide real-time search capabilities to AI assistants like Claude.
+
+
+<img width="1852" height="1738" alt="CleanShot 2025-08-06 at 16 05 16@2x" src="https://github.com/user-attachments/assets/35c7300f-6e5f-4d08-a298-f3ad2482fc5e" />
+
+## Prerequisites
+
+NOTE: This tool assumes you have a paid plan from kagi.com!
+
+Before using this tool, you need to obtain a Kagi search token:
+
+1. Visit [Kagi.com](https://kagi.com) and log in to your account
+2. On the main page, click on the hamburger icon on the top right corner, navigate to "Session Link" below the pop-up menu, click "Copy".
+3. Paste your Session link to a safe place. It may look like https://kagi.com/search?token=xxxx, where "xxxx" refers to your unique token. Copy this token for later use. Please follow Kagi's rules and keep this token secure as it provides access to your Kagi search quota. 
+
+## Installation
+
+### From npm
+
+```bash
+# Run the CLI directly with npx (no install)
+npx -p @dinerburger/kagi-search-mcp kagi-search "search keywords"
+
+# Or install globally
+npm install -g @dinerburger/kagi-search-mcp
+kagi-search "search keywords"
+```
+
+The Kagi token is read from the `KAGI_TOKEN` environment variable (or a `.env` file in the working directory).
+
+### From source
+
+```bash
+# Install from source
+git clone https://github.com/dinerburger/kagi-search-mcp.git
+cd kagi-search-mcp
+
+# Create a .env file and fill in your kagi token. 
+echo "KAGI_TOKEN={YOUR_KAGI_TOKEN_HERE}" > .env
+# Change YOUR_KAGI_TOKEN_HERE to your token
+
+# Install dependencies
+npm install
+# Or using yarn
+yarn
+# Or using pnpm
+pnpm install
+
+# Compile TypeScript code
+npm run build
+# Or using yarn
+yarn build
+# Or using pnpm
+pnpm build
+
+# Link package globally (required for MCP functionality)
+npm link
+# Or using yarn
+yarn link
+# Or using pnpm
+pnpm link
+```
+
+## ⚠️ Security Considerations
+
+**Before uploading to GitHub or sharing this project:**
+
+1. **Clean all state files**: Run `npm run clean:all` to remove cached data
+2. **Verify .gitignore**: Ensure sensitive files are properly excluded
+3. **Check for sensitive data**: Never commit `.env` files
+
+## Usage
+
+### Command Line Tool
+
+```bash
+# Direct command line usage
+kagi-search "search keywords"
+
+# Using command line options
+kagi-search --limit 5 --timeout 60000 "search keywords"
+
+# Or using npx
+npx -p @dinerburger/kagi-search-mcp kagi-search --limit 5 "search keywords"
+```
+
+#### Output Example
+
+```json
+{
+  "query": "youtube",
+  "results": [
+    {
+      "title": "YouTube",
+      "link": "https://www.youtube.com/",
+      "snippet": ""
+    },
+    {
+      "title": "💭 Copyparty - YouTube",
+      "link": "https://waylonwalker.com//thoughts-767",
+      "snippet": ""
+    },
+    {
+      "title": "YouTube - Wikipedia",
+      "link": "https://en.wikipedia.org/wiki/YouTube",
+      "snippet": ""
+    },
+    {
+      "title": "YouTube Kids",
+      "link": "https://www.youtubekids.com/?hl=en-GB",
+      "snippet": ""
+    },
+    // more results...
+  ]
+}
+```
+
+### MCP Server
+
+This project provides Model Context Protocol (MCP) server functionality, allowing AI assistants like Claude to directly use Kagi search capabilities. MCP is an open protocol that enables AI assistants to safely access external tools and data.
+
+```bash
+# Build the project
+pnpm build
+```
+
+### Docker
+
+A multi-stage `Dockerfile` is included for running the MCP server without installing Node.js locally. The container runs the MCP server over stdio, so it is meant to be launched as a subprocess by an MCP client or a proxy like [mcpo](https://github.com/open-webui/mcpo).
+
+```bash
+# Build the image
+docker build -t kagi-search-mcp .
+
+# Run it directly (stdio MCP server; requires -i so the client can talk to stdin)
+docker run -i --rm --env-file .env kagi-search-mcp
+```
+
+The Kagi session token is read from the `KAGI_TOKEN` environment variable — pass it with `--env-file .env` or `-e KAGI_TOKEN=...`.
+
+#### Hosting behind mcpo (OpenAPI/REST access)
+
+[mcpo](https://github.com/open-webui/mcpo) exposes any stdio MCP server as an OpenAPI-compatible HTTP server. Run mcpo on the host and point it at the container:
+
+```bash
+uvx mcpo --port 8000 --api-key "top-secret" -- \
+  docker run -i --rm --env-file .env kagi-search-mcp
+```
+
+The tool is then available at `http://localhost:8000` with auto-generated docs at `http://localhost:8000/docs`. The tool name is `kagi-search`, so it is exposed at the `/kagi-search` route.
+
+#### Integration
+
+I've only tested this with Cherry studio, so any update on typical mcp clients like Claude Desktop / VScode / Cursor would be appreciated.
+
+```JSON
+{
+  "mcpServers": {
+    "kagi-search": {
+      "command": "npx",
+      "args": ["-y", "@dinerburger/kagi-search-mcp"],
+      "env": {
+        "KAGI_TOKEN": "your_kagi_token_here"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```JSON
+{
+  "mcpServers": {
+    "kagi-search": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "KAGI_TOKEN=your_kagi_token_here", "dinerburger/kagi-search-mcp"]
+    }
+  }
+}
+```
+
+### Final Note
+
+This project is a fork of google-search, and I have remixed it mainly for personal use as a passionate Kagi fan. I am not a professional programmer, and this is still a work in progress, so any contributions would be appreciated.
+
+If this project violates any rights of Kagi, please inform me, and I will take it down if I receive such a message. That said, due to the nature of the project, it cannot tolerate heavy usage, and I have not tested it beyond my regular personal searching purposes. As long as you use it in a regular way like me, it should not be an issue.
+
+The next step is to suppport quick answer and !bang to allow the tool search more freely & accurately without posting too much cost on Kagi.

package/bin/kagi-search

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/src/index.js";

package/bin/kagi-search-mcp

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import "../dist/src/mcp-server.js";

package/dist/package.json

@@ -0,0 +1,71 @@
+{
+    "name": "@dinerburger/kagi-search-mcp",
+    "version": "1.0.0",
+    "description": "Kagi search CLI and MCP tool",
+    "type": "module",
+    "main": "dist/src/index.js",
+    "types": "dist/src/index.d.ts",
+    "files": [
+        "dist",
+        "bin",
+        "README.md"
+    ],
+    "bin": {
+        "kagi-search-mcp": "./bin/kagi-search-mcp",
+        "kagi-search": "./bin/kagi-search"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc",
+        "prepublishOnly": "npm run build",
+        "dev": "ts-node src/index.ts",
+        "start": "node dist/src/index.js",
+        "test": "ts-node src/index.ts \"typescript\"",
+        "test:build": "npm run build && node dist/src/index.js \"typescript\"",
+        "debug": "ts-node src/index.ts \"typescript\"",
+        "debug:build": "npm run build && node dist/src/index.js \"typescript\"",
+        "link": "npm link",
+        "clean": "node -e \"const fs = require('fs'); const path = require('path'); if (fs.existsSync('dist')) fs.rmSync('dist', { recursive: true, force: true });\"",
+        "clean:all": "bash scripts/clean.sh",
+        "clean:full": "bash scripts/clean.sh --full",
+        "mcp": "ts-node src/mcp-server.ts",
+        "mcp:build": "npm run build && node dist/src/mcp-server.js"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/dinerburger/kagi-search-mcp.git"
+    },
+    "homepage": "https://github.com/dinerburger/kagi-search-mcp#readme",
+    "bugs": {
+        "url": "https://github.com/dinerburger/kagi-search-mcp/issues"
+    },
+    "keywords": [
+        "kagi",
+        "search",
+        "cli",
+        "mcp",
+        "claude"
+    ],
+    "author": "dinerburger",
+    "license": "ISC",
+    "devDependencies": {
+        "@types/node": "^22.13.9",
+        "jsdom": "^26.0.0",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.8.2"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.6.1",
+        "commander": "^13.1.0",
+        "dotenv": "^17.2.1",
+        "node-html-parser": "^9.0.2",
+        "pino": "^9.6.0",
+        "pino-pretty": "^13.0.0",
+        "zod": "^3.22.4"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+import { config } from "dotenv";
+import { Command } from "commander";
+import { kagiSearch, getKagiSearchPageHtml } from "./search.js";
+// Load environment variables
+config();
+// Get package info
+import packageJson from "../package.json" with { type: "json" };
+// Create the command-line program
+const program = new Command();
+// Configure command-line options
+program
+    .name("kagi-search")
+    .description("Kagi search CLI tool using Kagi's HTML search endpoint")
+    .version(packageJson.version)
+    .argument("<query>", "Search query")
+    .option("-l, --limit <number>", "Maximum number of results", parseInt, 10)
+    .option("-t, --timeout <number>", "Timeout (milliseconds)", parseInt, 30000)
+    .option("--get-html", "Get the raw HTML of the search results page instead of parsed results")
+    .option("--save-html", "Save the HTML to a file")
+    .option("--html-output <path>", "HTML output file path")
+    .action(async (query, options) => {
+    try {
+        if (options.getHtml) {
+            // Get the HTML
+            const htmlResult = await getKagiSearchPageHtml(query, options, options.saveHtml || false, options.htmlOutput);
+            // If HTML was saved to a file, include the file path in the output
+            if (options.saveHtml && htmlResult.savedPath) {
+                console.log(`HTML saved to file: ${htmlResult.savedPath}`);
+            }
+            // Output the result (without the full HTML, to avoid excessive console output)
+            const outputResult = {
+                query: htmlResult.query,
+                url: htmlResult.url,
+                originalHtmlLength: htmlResult.originalHtmlLength, // Original HTML length (including CSS and JavaScript)
+                cleanedHtmlLength: htmlResult.html.length, // Cleaned HTML length (without CSS and JavaScript)
+                savedPath: htmlResult.savedPath,
+                // Only output the first 500 characters of HTML as a preview
+                htmlPreview: htmlResult.html.substring(0, 500) + (htmlResult.html.length > 500 ? '...' : '')
+            };
+            console.log(JSON.stringify(outputResult, null, 2));
+        }
+        else {
+            // Perform a regular search
+            const results = await kagiSearch(query, options);
+            // Output the results
+            console.log(JSON.stringify(results, null, 2));
+        }
+    }
+    catch (error) {
+        console.error("Error:", error);
+        process.exit(1);
+    }
+});
+// Parse command-line arguments
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGhE,6BAA6B;AAC7B,MAAM,EAAE,CAAC;AAET,mBAAmB;AACnB,OAAO,WAAW,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEhE,kCAAkC;AAClC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,iCAAiC;AACjC,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;KAC5B,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;KACnC,MAAM,CAAC,sBAAsB,EAAE,2BAA2B,EAAE,QAAQ,EAAE,EAAE,CAAC;KACzE,MAAM,CAAC,wBAAwB,EAAE,wBAAwB,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC3E,MAAM,CAAC,YAAY,EAAE,uEAAuE,CAAC;KAC7F,MAAM,CAAC,aAAa,EAAE,yBAAyB,CAAC;KAChD,MAAM,CAAC,sBAAsB,EAAE,uBAAuB,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAAwF,EAAE,EAAE;IACxH,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,eAAe;YACf,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAC5C,KAAK,EACL,OAAO,EACP,OAAO,CAAC,QAAQ,IAAI,KAAK,EACzB,OAAO,CAAC,UAAU,CACnB,CAAC;YAEF,mEAAmE;YACnE,IAAI,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,uBAAuB,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,+EAA+E;YAC/E,MAAM,YAAY,GAAG;gBACnB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,GAAG,EAAE,UAAU,CAAC,GAAG;gBACnB,kBAAkB,EAAE,UAAU,CAAC,kBAAkB,EAAE,sDAAsD;gBACzG,iBAAiB,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,mDAAmD;gBAC9F,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,4DAA4D;gBAC5D,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7F,CAAC;YAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAEjD,qBAAqB;YACrB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,+BAA+B;AAC/B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/logger.d.ts

@@ -0,0 +1,2 @@
+declare const logger: import("pino").Logger<never, boolean>;
+export default logger;

package/dist/src/logger.js

@@ -0,0 +1,53 @@
+import { pino } from "pino";
+import * as path from "path";
+import * as fs from "fs";
+import * as os from "os";
+// Use the system temp directory to ensure cross-platform compatibility
+const logDir = path.join(os.tmpdir(), "google-search-logs");
+if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+}
+// Create the log file path
+const logFilePath = path.join(logDir, "google-search.log");
+// Create the pino logger instance
+const logger = pino({
+    level: process.env.LOG_LEVEL || "info", // Log level can be set via environment variable
+    transport: {
+        targets: [
+            // Output to console, prettified with pino-pretty
+            {
+                target: "pino-pretty",
+                level: "info",
+                options: {
+                    colorize: true,
+                    translateTime: "SYS:yyyy-mm-dd HH:MM:ss",
+                    ignore: "pid,hostname",
+                },
+            },
+            // Output to file - use trace level to capture all logs
+            {
+                target: "pino/file",
+                level: "trace", // Use the lowest level to capture all logs
+                options: { destination: logFilePath },
+            },
+        ],
+    },
+});
+// Handle process exit
+process.on("exit", () => {
+    logger.info("Process exiting, closing logs");
+});
+process.on("SIGINT", () => {
+    logger.info("Received SIGINT signal, closing logs");
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    logger.info("Received SIGTERM signal, closing logs");
+    process.exit(0);
+});
+process.on("uncaughtException", (error) => {
+    logger.error({ err: error }, "Uncaught exception");
+    process.exit(1);
+});
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,uEAAuE;AACvE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC;AAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAC3B,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,2BAA2B;AAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAE3D,kCAAkC;AAClC,MAAM,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,gDAAgD;IACxF,SAAS,EAAE;QACT,OAAO,EAAE;YACP,iDAAiD;YACjD;gBACE,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;oBACd,aAAa,EAAE,yBAAyB;oBACxC,MAAM,EAAE,cAAc;iBACvB;aACF;YACD,uDAAuD;YACvD;gBACE,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,OAAO,EAAE,2CAA2C;gBAC3D,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE;aACtC;SACF;KACF;CACF,CAAC,CAAC;AAEH,sBAAsB;AACtB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;IACtB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/src/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/mcp-server.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { config } from "dotenv";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { kagiSearch } from "./search.js";
+import logger from "./logger.js";
+// Load environment variables
+config();
+// Create the MCP server instance
+const server = new McpServer({
+    name: "kagi-search",
+    version: "0.1.0",
+});
+// Register the Kagi search tool
+server.tool("kagi-search", "Search the web in real time using the Kagi search engine, returning search results with titles, links, and snippets. Kagi is a privacy-focused search engine that provides high-quality, ad-free results. Suitable for scenarios such as getting the latest information, finding material on a specific topic, researching current events, or verifying facts. Results are returned as JSON, containing the query and a list of matching results.", {
+    query: z
+        .string()
+        .describe("The search query string. For best results: 1) use specific keywords rather than vague phrases; 2) use quotes around an \"exact phrase\" to force a match; 3) use site:domain to restrict results to a specific site; 4) use - to exclude words from the results; 5) use OR to connect alternative terms; 6) prefer technical terminology; 7) keep it to 2-5 keywords for balanced results. For example: 'climate change report 2024 site:gov -opinion' or '\"machine learning algorithms\" tutorial (Python OR Julia)'"),
+    limit: z
+        .number()
+        .optional()
+        .describe("Number of search results to return (default: 10, recommended range: 1-20)"),
+    timeout: z
+        .number()
+        .optional()
+        .describe("Timeout for the search operation in milliseconds (default: 30000)"),
+}, async (params) => {
+    try {
+        const { query, limit, timeout } = params;
+        logger.info({ query }, "Performing Kagi search");
+        const results = await kagiSearch(query, { limit, timeout });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(results, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        logger.error({ error }, "Search tool execution error");
+        return {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: `Search failed: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+});
+// Start the server
+async function main() {
+    try {
+        logger.info("Starting Kagi search MCP server...");
+        // Check environment variables
+        if (!process.env.KAGI_TOKEN && !process.env.KAGI_SESSION_TOKEN) {
+            logger.error("KAGI_TOKEN environment variable is not set. Please set your Kagi token in the .env file.");
+            process.exit(1);
+        }
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        logger.info("Kagi search MCP server started, waiting for connections...");
+    }
+    catch (error) {
+        logger.error({ error }, "Failed to start the server");
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=mcp-server.js.map

package/dist/src/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../src/mcp-server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,6BAA6B;AAC7B,MAAM,EAAE,CAAC;AAET,iCAAiC;AACjC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,gCAAgC;AAChC,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mbAAmb,EACnb;IACE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,CACP,wfAAwf,CACzf;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,EACD,KAAK,EAAE,MAAM,EAAE,EAAE;IACf,IAAI,CAAC;QACH,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,6BAA6B,CAAC,CAAC;QAEvD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kBACJ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;iBACH;aACF;SACF,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,mBAAmB;AACnB,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAElD,8BAA8B;QAC9B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,0FAA0F,CAAC,CAAC;YACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEhC,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,4BAA4B,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/src/search.d.ts

@@ -0,0 +1,19 @@
+import { SearchResponse, CommandOptions, HtmlResponse } from "./types.js";
+/**
+ * Perform a Kagi search and return the results
+ * @param query Search keywords
+ * @param options Search options
+ * @returns Search results
+ */
+export declare function kagiSearch(query: string, options?: CommandOptions): Promise<SearchResponse>;
+/**
+ * Get the raw HTML of the Kagi search results page
+ * @param query Search keywords
+ * @param options Search options
+ * @param saveToFile Whether to save the HTML to a file
+ * @param outputPath Output file path
+ * @returns HTML response
+ */
+export declare function getKagiSearchPageHtml(query: string, options?: CommandOptions, saveToFile?: boolean, outputPath?: string): Promise<HtmlResponse>;
+export declare const googleSearch: typeof kagiSearch;
+export declare const getGoogleSearchPageHtml: typeof getKagiSearchPageHtml;

package/dist/src/search.js

@@ -0,0 +1,183 @@
+import { parse } from "node-html-parser";
+import * as fs from "fs";
+import logger from "./logger.js";
+// Kagi serves the fully server-rendered "HTML-only" search UI at /html/search,
+// which is designed for browsers without JavaScript. A plain HTTP request with
+// a browser-like User-Agent and the session cookie works fine — no headless
+// browser or bot-evasion machinery required.
+const KAGI_HTML_SEARCH_URL = "https://kagi.com/html/search";
+const USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.2 Safari/605.1.15";
+/**
+ * Get the Kagi session token from environment variables.
+ * Accepts KAGI_SESSION_TOKEN or the legacy KAGI_TOKEN variable name.
+ */
+function getKagiToken() {
+    const token = process.env.KAGI_SESSION_TOKEN || process.env.KAGI_TOKEN;
+    if (!token) {
+        throw new Error("KAGI_TOKEN environment variable is not set. Please set your Kagi session token in the .env file.");
+    }
+    return token;
+}
+/**
+ * Perform a GET request against Kagi's HTML search endpoint.
+ * @param query Search keywords
+ * @returns Raw HTML of the search results page
+ */
+async function fetchKagiSearchHtml(query) {
+    const token = getKagiToken();
+    const response = await fetch(`${KAGI_HTML_SEARCH_URL}?q=${encodeURIComponent(query)}`, {
+        headers: {
+            "User-Agent": USER_AGENT,
+            Cookie: `kagi_session=${token}`,
+        },
+    });
+    if (!response.ok) {
+        if (response.status === 401 || response.status === 403) {
+            throw new Error("Invalid or expired Kagi session token");
+        }
+        throw new Error(`Kagi search request failed: HTTP ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}
+/**
+ * Extract a single search result element.
+ * @param element A `.search-result` container element
+ * @returns A search result, or null if the element could not be parsed
+ */
+function extractSearchResult(element) {
+    try {
+        const titleLink = element.querySelector(".__sri_title_link");
+        if (!titleLink)
+            return null;
+        const title = titleLink.textContent.trim();
+        const link = titleLink.getAttribute("href") || "";
+        const snippetElement = element.querySelector(".__sri-desc");
+        const snippet = snippetElement ? snippetElement.textContent.trim() : "";
+        if (!title || !link)
+            return null;
+        return { title, link, snippet };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract a single result from a grouped result element.
+ * @param element A `.__srgi` grouped result container element
+ * @returns A search result, or null if the element could not be parsed
+ */
+function extractGroupedResult(element) {
+    try {
+        const titleLink = element.querySelector(".__srgi-title a");
+        if (!titleLink)
+            return null;
+        const title = titleLink.textContent.trim();
+        const link = titleLink.getAttribute("href") || "";
+        const snippetElement = element.querySelector(".__sri-desc");
+        const snippet = snippetElement ? snippetElement.textContent.trim() : "";
+        if (!title || !link)
+            return null;
+        return { title, link, snippet };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse search results from the Kagi HTML search page.
+ * @param html Raw HTML of the search results page
+ * @param limit Maximum number of results to return
+ * @returns Parsed search results
+ */
+function parseSearchResults(html, limit) {
+    const root = parse(html);
+    const results = [];
+    // Top-level results
+    for (const element of root.querySelectorAll(".search-result")) {
+        if (results.length >= limit)
+            break;
+        const result = extractSearchResult(element);
+        if (result) {
+            results.push(result);
+        }
+    }
+    // Grouped results (news, images, etc.), only if we still need more
+    if (results.length < limit) {
+        for (const element of root.querySelectorAll(".sr-group .__srgi")) {
+            if (results.length >= limit)
+                break;
+            const result = extractGroupedResult(element);
+            if (result) {
+                results.push(result);
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Perform a Kagi search and return the results
+ * @param query Search keywords
+ * @param options Search options
+ * @returns Search results
+ */
+export async function kagiSearch(query, options = {}) {
+    const { limit = 10 } = options;
+    logger.info({ query }, "Performing Kagi search");
+    const html = await fetchKagiSearchHtml(query);
+    const results = parseSearchResults(html, limit);
+    logger.info({ count: results.length }, "Successfully extracted search results");
+    return {
+        query,
+        results,
+    };
+}
+/**
+ * Clean raw page HTML by removing script tags, style tags, and comments.
+ * @param html Raw page HTML
+ * @returns Cleaned HTML
+ */
+function cleanHtml(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<!--[\s\S]*?-->/g, "");
+}
+/**
+ * Get the raw HTML of the Kagi search results page
+ * @param query Search keywords
+ * @param options Search options
+ * @param saveToFile Whether to save the HTML to a file
+ * @param outputPath Output file path
+ * @returns HTML response
+ */
+export async function getKagiSearchPageHtml(query, options = {}, saveToFile = false, outputPath) {
+    logger.info({ query }, "Fetching Kagi search page HTML...");
+    const originalHtml = await fetchKagiSearchHtml(query);
+    const cleanedHtml = cleanHtml(originalHtml);
+    let savedPath;
+    // Save the HTML to a file (if requested)
+    if (saveToFile) {
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const defaultPath = `kagi-search-${timestamp}.html`;
+        savedPath = outputPath || defaultPath;
+        try {
+            fs.writeFileSync(savedPath, originalHtml, "utf8");
+            logger.info({ path: savedPath }, "HTML saved to file");
+        }
+        catch (error) {
+            logger.error({ error, path: savedPath }, "Failed to save the HTML file");
+            savedPath = undefined;
+        }
+    }
+    return {
+        query,
+        html: cleanedHtml,
+        url: `${KAGI_HTML_SEARCH_URL}?q=${encodeURIComponent(query)}`,
+        savedPath,
+        originalHtmlLength: originalHtml.length,
+    };
+}
+// For backward compatibility, export the old function names (but using the new implementation)
+export const googleSearch = kagiSearch;
+export const getGoogleSearchPageHtml = getKagiSearchPageHtml;
+//# sourceMappingURL=search.js.map

package/dist/src/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/search.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Search result interface
+ */
+export interface SearchResult {
+    title: string;
+    link: string;
+    snippet: string;
+}
+/**
+ * Search response interface
+ */
+export interface SearchResponse {
+    query: string;
+    results: SearchResult[];
+}
+/**
+ * Command-line options interface
+ */
+export interface CommandOptions {
+    limit?: number;
+    timeout?: number;
+    locale?: string;
+}
+/**
+ * HTML response interface - used for fetching the raw search page HTML
+ */
+export interface HtmlResponse {
+    query: string;
+    html: string;
+    url: string;
+    savedPath?: string;
+    originalHtmlLength?: number;
+}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@dinerburger/kagi-search-mcp",
+  "version": "1.0.0",
+  "description": "Kagi search CLI and MCP tool",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "bin": {
+    "kagi-search-mcp": "./bin/kagi-search-mcp",
+    "kagi-search": "./bin/kagi-search"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/src/index.js",
+    "test": "ts-node src/index.ts \"typescript\"",
+    "test:build": "npm run build && node dist/src/index.js \"typescript\"",
+    "debug": "ts-node src/index.ts \"typescript\"",
+    "debug:build": "npm run build && node dist/src/index.js \"typescript\"",
+    "link": "npm link",
+    "clean": "node -e \"const fs = require('fs'); const path = require('path'); if (fs.existsSync('dist')) fs.rmSync('dist', { recursive: true, force: true });\"",
+    "clean:all": "bash scripts/clean.sh",
+    "clean:full": "bash scripts/clean.sh --full",
+    "mcp": "ts-node src/mcp-server.ts",
+    "mcp:build": "npm run build && node dist/src/mcp-server.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dinerburger/kagi-search-mcp.git"
+  },
+  "homepage": "https://github.com/dinerburger/kagi-search-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/dinerburger/kagi-search-mcp/issues"
+  },
+  "keywords": [
+    "kagi",
+    "search",
+    "cli",
+    "mcp",
+    "claude"
+  ],
+  "author": "dinerburger",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^22.13.9",
+    "jsdom": "^26.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.2"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "commander": "^13.1.0",
+    "dotenv": "^17.2.1",
+    "node-html-parser": "^9.0.2",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0",
+    "zod": "^3.22.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}