Free Search

Name: Free Search
Author: sweetcornna

โดย sweetcornnaรุ่น 0.18.0i★ 178iรันบนเครื่อง

ชื่อใน registryio.github.sweetcornna/free-search-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

ต่อแบบ ติดตั้งในเครื่อง
บัญชีหรือคีย์ ต้องมี SEARCH_MCP_PROXY
หมวด ค้นข้อมูลและความจำของ AI

คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)

No-API-key web search, page fetching and document reading across many engines. Local-first.

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 13 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

Claudeเว็บ · แอป · มือถือChatGPTเว็บClaude CodeTerminalCursorโปรแกรมเขียนโค้ดVS Codeโปรแกรมเขียนโค้ดอื่น ๆโปรแกรมอื่น

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

ดาวน์โหลดไฟล์ติดตั้งของผู้ทำ
ดาวน์โหลดไฟล์ .mcpb ของผู้ทำ
ไฟล์ .mcpb มาจากผู้ทำโดยตรง เราไม่ได้แก้ไฟล์
ทำแล้ว
ดับเบิลคลิกไฟล์ แล้วกด Install ในแอป Claude บนคอม
ทำแล้ว
ลองเลย
ใช้ Free Search บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Claude บอกว่ากำลังใช้ Free Search หรือมีชื่อเครื่องมือของ Free Search ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ChatGPT ยังต่อ Free Search ไม่ได้

Free Search ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ

คุณทำแบบนี้แทนได้

ก · ใช้แอปที่ต่อ Free Search ได้

ดูขั้นตอนสำหรับ Claude →ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
ดูขั้นตอนสำหรับ Claude Code →ต้องมีคีย์ของ Free Search (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ดูขั้นตอนสำหรับ Cursor →ต้องมีคีย์ของ Free Search (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)
ดูขั้นตอนสำหรับ VS Code →ต้องมีคีย์ของ Free Search (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ข · ตัวอื่นในหมวด ค้นข้อมูลและความจำของ AI ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

Context7✓ ChatGPT
AIHOT✓ ChatGPT
Sui Knowledge Base (kapa.ai)✓ ChatGPT

ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน

ต้องมีคีย์ของ Free Search (สร้างที่เว็บของผู้ทำ) · ต้องลง Python (uv) ในเครื่องก่อน (ทำครั้งเดียว)

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Free Search
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Free Search ↗
ทำแล้ว
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
ทำแล้ว
4
วางคำสั่งนี้แล้วกด Enter
```
claude mcp add --scope user free-search --env SEARCH_MCP_PROXY='ใส่ค่าของคุณ' --env SEARCH_MCP_REGION='ใส่ค่าของคุณ' --env SEARCH_MCP_CACHE_DIR='ใส่ค่าของคุณ' -- uvx free-search-mcp
```
แก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
พิมพ์ /mcp ใน Claude Code
ต้องเห็น Free Search ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ทำแล้ว
ลองเลย
ใช้ Free Search บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Claude Code บอกว่ากำลังใช้ Free Search หรือมีชื่อเครื่องมือของ Free Search ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Free Search
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Free Search ↗
ทำแล้ว
กดปุ่มนี้เพื่อเปิด Cursor
เปิดใน Cursor
Cursor จะถามยืนยันการติดตั้ง ให้กด Install
ทำแล้ว
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ Free Search ช่อง SEARCH_MCP_PROXY, SEARCH_MCP_REGION, SEARCH_MCP_CACHE_DIR ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
เปิดแชตของ AI ใน Cursor โหมด Agent
ทำแล้ว
ลองเลย
ใช้ Free Search บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า Cursor บอกว่ากำลังใช้ Free Search หรือมีชื่อเครื่องมือของ Free Search ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน

ลง Python (uv) ในเครื่อง
ทำครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Python (uv)
เปิดหน้าดาวน์โหลด Python (uv) ↗
ทำแล้ว
สมัครและสร้างคีย์ของ Free Search
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
เปิดเว็บของ Free Search ↗
ทำแล้ว
กดปุ่มนี้เพื่อเปิด VS Code
เปิดใน VS Code
VS Code จะถามยืนยันการติดตั้ง ให้กด Install
ทำแล้ว
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ Free Search ช่อง SEARCH_MCP_PROXY, SEARCH_MCP_REGION, SEARCH_MCP_CACHE_DIR ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ทำแล้ว
เปิดแชตของ AI ใน VS Code โหมด Agent
ทำแล้ว
ลองเลย
ใช้ Free Search บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง
✓ ถ้า VS Code บอกว่ากำลังใช้ Free Search หรือมีชื่อเครื่องมือของ Free Search ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Free Search อยู่💬 พูดคุย →

สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ติดตั้งในเครื่อง

Claude Code

claude mcp add --scope user free-search --env SEARCH_MCP_PROXY='ใส่ค่าของคุณ' --env SEARCH_MCP_REGION='ใส่ค่าของคุณ' --env SEARCH_MCP_CACHE_DIR='ใส่ค่าของคุณ' -- uvx free-search-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "free-search": {
      "command": "uvx",
      "args": [
        "free-search-mcp"
      ],
      "env": {
        "SEARCH_MCP_PROXY": "ใส่ค่าของคุณ",
        "SEARCH_MCP_REGION": "ใส่ค่าของคุณ",
        "SEARCH_MCP_CACHE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "free-search": {
      "command": "uvx",
      "args": [
        "free-search-mcp"
      ],
      "env": {
        "SEARCH_MCP_PROXY": "ใส่ค่าของคุณ",
        "SEARCH_MCP_REGION": "ใส่ค่าของคุณ",
        "SEARCH_MCP_CACHE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "free-search": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "free-search-mcp"
      ],
      "env": {
        "SEARCH_MCP_PROXY": "ใส่ค่าของคุณ",
        "SEARCH_MCP_REGION": "ใส่ค่าของคุณ",
        "SEARCH_MCP_CACHE_DIR": "ใส่ค่าของคุณ"
      }
    }
  }
}

ค่าที่ต้องใส่เอง

SEARCH_MCP_PROXY ความลับ env
Optional outbound proxy URL (http://, https:// or socks5://) for engines that block your network.
SEARCH_MCP_REGION env
Optional default region-language for results, e.g. us-en, uk-en, cn-zh. Default: us-en.
SEARCH_MCP_CACHE_DIR env
Optional directory for the local search/page cache. Default: ~/.cache/search-mcp.

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาว GitHub i: 178
ดาวน์โหลดต่อสัปดาห์i: 913/สัปดาห์
license i: MIT
การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
รุ่นล่าสุดi: 0.18.0
หมวดi: ค้นข้อมูลและความจำของ AI
ส่งเข้า registryi: 31 ต.ค. 2569
แก้โค้ดล่าสุดi: 31 ต.ค. 2569
ผู้ทำ: sweetcornna
แพ็กเกจ: pypi: free-search-mcp
mcpb: …/free-search-mcp-0.18.0.mcpb
repo: sweetcornna/free-search-mcp
เว็บผู้ทำ: github.com
สถานะใน registry: ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ติดตั้งบนเครื่องได้ใน

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

เรื่องที่ 8เช็ก 5 ข้อก่อนติดตั้ง MCP ไม่ให้ข้อมูลรั่วใช้เวลาราว 2 นาทีต่อตัว ดูจากหน้าของตัวนั้นบนเว็บเรา และหน้าขออนุญาตของโปรแกรม AI ก่อนกดยอมอ่าน 4 นาที

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 13 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub sweetcornna ซึ่งเป็นเจ้าของ repo
✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 13 วันที่ผ่านมา
✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบด้วย Google เพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

ดาวมากกว่า 98% ของอีก 6029 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 75% ของอีก 6029 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 6029 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Free Search ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

ต้องใส่ค่าเหล่านี้: SEARCH_MCP_PROXY

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 13 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.18.0) เข้า registry 13 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv), MCPB ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Context7, Codebase Memory, Ruflo

ตัวอื่นในหมวดเดียวกัน

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Context7

ส่งคู่มือการใช้ไลบรารีและเฟรมเวิร์กรุ่นล่าสุดให้ AI อ่านก่อนตอบ ช่วยให้โค้ดที่ AI เขียนไม่ใช้คำสั่งเก่าที่เลิกใช้แล้ว

โดย upstashใช้กันมาก↓ 1.2M/สัปดาห์★ 64.7Kอัปเดต เมื่อวาน

บนเครื่องหรือคลาวด์

ติดตั้ง

Codebase Memory

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

โดย DeusDataใช้กันมาก↓ 16.8K/สัปดาห์★ 48.6Kอัปเดต 27 วันที่ผ่านมา

รันบนเครื่อง

ติดตั้ง

Ruflo

Agent teams, swarms, memory and hooks for Claude Code and Codex, served over MCP.

โดย ruvnetใช้กันมาก↓ 74.3K/สัปดาห์★ 81.6K ดาวรวมทั้งรีโปอัปเดต วันนี้

รันบนเครื่อง

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

free-search-mcp

https://github.com/user-attachments/assets/354b522a-ef6b-4547-bb07-c80c6268a5e8

Music: “Ethereal Space (cdk Mix)” by cdk, ccmixter.org/files/cdk/34151 , licensed CC BY 3.0 .

free-search-mcp is a local-first Model Context Protocol server that needs no API key. It lets any LLM (Claude, GPT, a local Ollama model, …) search the web, fetch and clean up pages, and read documents, and you never sign up for a search API.

It combines ideas from several open-source MCP servers in one Python package, and adds the output shaping for LLMs and the reliability work that each of them lacked.

research("how does reciprocal rank fusion work", depth=3)

↓

Research brief: how does reciprocal rank fusion work

_engines: duckduckgo, bing, yahoojp, anysearch · sources: 3 · ~3,400 tokens_

Sources

[1] Reciprocal rank fusion | Elasticsearch Reference — https://…
[2] Hybrid Search Scoring (RRF) | Microsoft Learn — https://…
[3] RRF explained in 4 mins — Medium — https://…

Documents

…full Markdown bodies of each page, ready for the LLM to read…

That was one tool call. It returned three sources with their full text, and no API key was involved.

Quick start

You need uv and nothing else: no sign-up, no API key, no clone.

In Claude Code, inside a session:

/plugin marketplace add sweetcornna/free-search-mcp

/plugin install free-search@free-search-mcp

In Codex:

codex plugin marketplace add sweetcornna/free-search-mcp

codex plugin add free-search@free-search-mcp

(In Codex, a [mcp_servers.search] entry left in ~/.codex/config.toml by an earlier codex mcp add silently shadows the plugin's server. Remove it with codex mcp remove search.)

The plugin brings the 11 tools, the verified-research skill (how to check a snippet against its page and its date) and, in Claude Code, the free-search:quick-search agent, all pinned to one version. /plugin update free-search moves to the next release.

Optionally, install Chromium once for the browser-rendered engines (brave, zhihu, …) and JavaScript-heavy pages. Everything else works without it, and a call that needs it returns this command as its error:

uvx --from free-search-mcp playwright install chromium

Claude Desktop, other clients, a source checkout and Docker are under Install.

Why this exists

	Multi-engine	No API key	Smart fallback	PDF/DOCX	FTS5 cache	Filters	Trafilatura	LLM-tuned
`nickclyde/duckduckgo-mcp-server`	✗	✓	✗	✗	✗	✗	✗	~
`mrkrsl/web-search-mcp`	✓	✓	✓	✗	✗	✗	✗	~
`Aas-ee/open-webSearch`	✓	✓	~	✗	✗	✗	✗	~
`VincentKaufmann/noapi-google-search-mcp`	✗	✓	✓	✓	✓	✗	✗	~
free-search-mcp	✓	✓	✓	✓	✓	✓	✓	✓

"LLM-tuned" means Markdown-first output with token estimates, errors that name the next step, and a research() that turns a search and its fetches into one call. docs/HOW_IT_WORKS.md explains the less obvious columns.

Tools (11)

Tool	Description
`search(query, ...filters)`	Parallel multi-engine search, RRF-merged, title-fuzzy + host-canonical deduped, with optional extractive `lead_snippet`
`research(question, depth?, ...filters)`	One-shot: search + fetch top N + return Markdown brief
`paper_graph(paper, direction?, limit?)`	Walk one paper's citation graph: references, citing works ranked by influence, and Crossref retraction/correction notices. Takes a DOI, an OpenAlex ID, an exact title, or an arXiv reference (`arXiv:1706.03762`, an `arxiv.org/abs/…` URL, a `10.48550/arXiv.…` DOI, or a bare id such as `1706.03762`, `2401.12345v3` or `hep-th/9901001` when it is the whole input)
`compare(question, urls=[2..5])`	Concurrent fetch of 2-5 URLs, side-by-side excerpts keyed by question
`fetch(url, render?, inline?, ...)`	Fetch any resource: reader-mode Markdown for pages, parsed text for documents, or a description (type/size/dimensions/sha256) for images and binaries. `inline=True` returns the image itself for vision models
`fetch_batch(urls, ...)`	Concurrent multi-URL fetch (max 20 per call)
`read_doc(source, start?, length?, ...)`	Parse PDF / DOCX / XLSX / PPTX / EPUB / CSV / code / zip-tar / HTML / TXT / MD with pagination
`extract_structured(url, ...)`	Pull JSON-LD / OpenGraph / Twitter cards / microdata via extruct. Long prose fields (`articleBody` and the like) are clipped, and the result says so in `trimmed`. This tool returns metadata; use `fetch` for the text
`cache_search(query, limit?, ...)`	FTS5 search across previously fetched pages
`engines(group?)`	The source tree (group, then sub-group, then engine), one line each. `group` is an enum of the groups that own engines, so a typo fails schema validation
`download(url, ...)`	Save a file to `${SEARCH_MCP_CACHE_DIR}/downloads` by default; files auto-delete after 24h. Set `SEARCH_MCP_DOWNLOAD_ENABLED=false` to disable it.

There are also 5 MCP prompts and 2 resource templates (cache://page/{url}, cache://search/{query_hash}). A twelfth tool, ask, appears only when an answer backend is configured (see Delegating a lookup).

search and research take these filters:

Param	Values	Effect
`freshness`	`day` / `week` / `month` / `year`	Only results from the last N. Results with no date are kept, and `freshness_note` says when that is most of them. `day` / `week` also add `googlenews`
`include_domains`	`["python.org", "djangoproject.com"]`	Restrict to these domains
`exclude_domains`	`["pinterest.com"]`	Remove these
`category`	a group (`paper`, `finance`, `news`, `software`, `security`, `weather`, …) or a sub-group (`paper.biomed`, `finance.filings`, `finance.fx`, `software.python`, `dataset.ml`, …)	Routes to the sources that natively index that kind of thing; the enum in the tool schema lists every value
`include_text`	`"async"`	Substring required in title/snippet
`exclude_text`	`"beginner"`	Substring forbidden
`max_age_hours`	`24`	Accept a cached answer only if it is younger than this. Default 7 days; the tightest of this, the `freshness` window's TTL, the 6-hour news cap and the category's own cap (`weather`, `finance.fx` 1 hour; `software`, `security` 6 hours) wins

Output is Markdown by default, with provenance and a token estimate in the header. format="json" returns structured data.

How a search runs

A search that names no engines asks a small keyless pool: duckduckgo, bing, yahoojp (Yahoo! JAPAN, the keyless route to Google's index) and anysearch. googlenews joins when recency is asked for, so360 and quark when the query is written in Chinese, naver when it is written in Korean. Sources that only served a CAPTCHA or an empty shell (mojeek, google, startpage, searx, sogou) were removed rather than left to fail on every fresh process.
category= routes to sources that index that kind of thing (papers, filings, datasets, packages, CVEs, …). Record sources such as pypi, nvd or openmeteo also join by themselves when the question is one they can answer directly.
An engine that serves a CAPTCHA, a login wall or an off-topic page is benched, a reserve takes its seat, and the response says what happened. A proxy (SEARCH_MCP_PROXY) is the fix for IP gating.
Once you have signed in to codex, it searches beside those engines on every such search and its results join the same ranking (the agent lane). The links never wait more than 6 s for it.
With an answer backend configured (SEARCH_MCP_AGENT_BACKEND=api, claude-code or codex), search also runs the answer agent beside the engines from the same result set and puts a short sourced answer above the links. SEARCH_MCP_AGENT_IN_SEARCH=false turns that off; ask stays available either way.
Every result says how old it is and where its date came from, so the agent can tell a lead from a checked fact.
engines() prints the whole source tree. engines=["so360", "baidu"] runs exactly the engines named.

No engine that a search reaches by itself needs a key. The details, with measurements, are in docs/HOW_IT_WORKS.md; walls and proxies in docs/PROXY_AND_GATES.md; a tour of the tools with examples in docs/USAGE.md.

Install

The plugin in Quick start is the recommended path, because the server is pinned to the plugin's version and updates with it. The other routes run the same server:

Where	How
Claude Desktop	open `free-search-mcp- .mcpb` from the latest release
MCP Registry	`io.github.sweetcornna/free-search-mcp`
Claude Code, without the plugin	`claude mcp add search -s user -- uvx free-search-mcp`
Codex, without the plugin	`codex mcp add search -- uvx free-search-mcp`
Hermes Agent (the plugin)	`hermes plugins install sweetcornna/free-search-mcp/plugins/free-search --enable`
Any other MCP client	the stdio command `uvx free-search-mcp`
Docker	`docker compose build`, then `docker compose run --rm search-mcp`

A source checkout with Chromium, a smoke test and client registration in one step:

curl -LsSf https://raw.githubusercontent.com/sweetcornna/free-search-mcp/main/scripts/install.sh | bash -s -- --client claude-code

Over HTTP, uvx free-search-mcp --transport streamable-http --port 8000 serves http://127.0.0.1:8000/mcp. That endpoint has no authentication and fetches any URL for whoever reaches it, so keep it on loopback or put an authenticating proxy in front.

The JSON for Claude Desktop, Cursor, Cline, Continue and Zed, the installer's options and the plugin's token cost are in docs/INSTALL.md. Operating rules for agents are in docs/AGENT_USAGE.md.

Search on your own account: `codex` and `antigravity`

Two opt-in engines search on an account you sign in with instead of an API key. Neither is in any pool or route, and nothing changes for anyone who never signs in. Once you sign in to codex, it searches beside the keyless engines on every automatic search (the agent lane); antigravity runs only when a call or SEARCH_MCP_AGENT_ENGINES names it.

	`codex`	`antigravity`
Searches with	OpenAI's web search, the one Codex uses	Google Search, run by a Gemini model
Account	a ChatGPT plan that includes Codex	a Google account with Antigravity
Each search counts against	the plan's Codex usage	the account's Antigravity quota
The provider allows it	yes	no, see the warning below
Opens a sign-in page by itself	on first use, over stdio on a desktop	never
Full guide, with 中文速览	docs/CODEX_SEARCH.md	docs/ANTIGRAVITY_SEARCH.md

Warning: Google's Antigravity terms forbid using its sign-in from third-party

tools and name suspension of the Antigravity and Gemini CLI accounts as the

consequence, and Google has suspended accounts for it. Sign in to

antigravity only with an account you accept that risk for.

ตัดมาแค่ช่วงต้น อ่านต่อใน repo

Free Search

ใช้ทำอะไรได้

ติดตั้ง

ดาวน์โหลดไฟล์ติดตั้งของผู้ทำ

ดับเบิลคลิกไฟล์ แล้วกด Install ในแอป Claude บนคอม

ลองเลย

คุณทำแบบนี้แทนได้

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Free Search

เปิด Terminal

วางคำสั่งนี้แล้วกด Enter

พิมพ์ /mcp ใน Claude Code

ลองเลย

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Free Search

กดปุ่มนี้เพื่อเปิด Cursor

ใส่คีย์ในช่องที่ว่างไว้

เปิดแชตของ AI ใน Cursor โหมด Agent

ลองเลย

ลง Python (uv) ในเครื่อง

สมัครและสร้างคีย์ของ Free Search

กดปุ่มนี้เพื่อเปิด VS Code

ใส่คีย์ในช่องที่ว่างไว้

เปิดแชตของ AI ใน VS Code โหมด Agent

ลองเลย

ติดตั้งในเครื่อง

ค่าที่ต้องใส่เอง

สรุป

ใช้กับโปรแกรมไหนได้

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

พูดคุย

รีวิวจากผู้ใช้

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

คำถามที่พบบ่อย

ตัวอื่นในหมวดเดียวกัน

Context7

Codebase Memory

Ruflo

README จากผู้ทำ

free-search-mcp

Research brief: how does reciprocal rank fusion work

Sources

Documents

Quick start

Why this exists

Tools (11)

How a search runs

Install

Search on your own account: codex and antigravity

Search on your own account: `codex` and `antigravity`