convez.ai
MCP ServerBusca & PesquisaIntermediário
Backerss

Web Search MCP Server

Backerss/web-search-mcp

Busca web grátis e pesquisa profunda com citações via SearXNG

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server para busca web e extração de conteúdo 100% gratuita usando SearXNG. Oferece ferramentas de busca, busca de imagens e pesquisa profunda com citações, sem necessidade de API keys ou registro. Integra-se com OpenWebUI, Claude Code e outras interfaces MCP.

Instalação

$npx convez-ai Backerss/web-search-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Integrar busca web em agentes Claude sem custo de API
  • Pesquisa profunda com múltiplas fontes e referências automáticas
  • Extração de conteúdo de páginas web em tempo real
  • Busca de imagens e integração visual em respostas de IA

Veredito

Solução robusta e bem documentada para democratizar busca web em ambientes MCP. A arquitetura Docker é acessível, mas requer gerenciamento local de infraestrutura; ideal para quem quer autonomia total sem custos de API.

README

A tradução para o português deste README ainda está na fila.

Free Web Search MCP 🔍

MCP server สำหรับ ค้นหาเว็บ + อ่านเนื้อหาหน้าเว็บ แบบฟรี 100% ไม่ต้องสมัคร ไม่ต้องมี API key ของ Google/Bing — ใช้ SearXNG (meta-search ที่รันเองบน Docker)

ให้ OpenWebUI หรือ CLI ที่ไม่มี search engine สามารถ "เสิร์ชอินเทอร์เน็ต" ได้

เครื่องมือ (tools) ที่ให้

Toolหน้าที่
web_search(query, num_results, language)ค้นหาเว็บ คืนชื่อเรื่อง + ลิงก์ + สรุปย่อ
fetch_url(url, max_chars)ดึงเนื้อหาหลักของหน้าเว็บ แปลงเป็นข้อความสะอาด
image_search(query, num_results, language)ค้นรูปภาพ คืน markdown ฝังรูป + ลิงก์แหล่งที่มา
deep_research(query, num_sources, max_chars_per_source, include_images, language)วิจัยเชิงลึก: ค้นหลายแหล่งพร้อมกัน ดึงเนื้อหาเต็ม รวมเป็นเอกสารเดียวพร้อมเลขอ้างอิง [1][2]… + รูปภาพ + รายการแหล่งอ้างอิง

Deep Research ทำงานยังไง? ตัว MCP รวบรวม "หลักฐาน" จากหลายแหล่ง (ฟรี ไม่ต้องมี LLM/API key) แล้วส่งเนื้อหา+อ้างอิง+รูปกลับไป ให้ LLM ใน OpenWebUI เป็นคนเรียบเรียงสรุปโดยอ้างอิงเลข [n] — ได้ผลแนวเดียวกับ Deep Research โดยไม่เสียเงิน

สถาปัตยกรรม

OpenWebUI ──HTTP/OpenAPI──> mcpo ──MCP stdio──> server.py ──HTTP──> SearXNG ──> อินเทอร์เน็ต
CLI (Claude Code/Cline) ───────────MCP stdio──> server.py ──┘

วิธีติดตั้ง (Docker — แนะนำ)

cd "Code VSTH/web-search-mcp"

# 1) ตั้ง secret_key ของ SearXNG ให้เป็นค่าสุ่ม
#    แก้ไฟล์ searxng/settings.yml บรรทัด secret_key

# 2) (ทางเลือก) ตั้ง API key ให้ mcpo
cp .env.example .env        # แล้วใส่ MCPO_API_KEY ถ้าต้องการ

# 3) สั่งรันทั้งระบบ
docker compose up -d --build

ตรวจสอบ:

  • SearXNG : http://localhost:8080 (ลองค้นหาดูได้)
  • OpenAPI docs : http://localhost:8000/docs (จะเห็น web_search / fetch_url)
  • ทดสอบ JSON API ของ SearXNG :
    curl "http://localhost:8080/search?q=test&format=json"
    

ต่อกับ OpenWebUI

  1. เปิด OpenWebUI → Settings → Tools (หรือ Admin → Settings → Tools / Functions → External Tools)
  2. Add Tool Server ใส่ URL:
    http://localhost:8000
    

    ถ้า OpenWebUI รันใน Docker คนละ network ให้ใช้ http://host.docker.internal:8000 หรือเอา service mcp ไปอยู่ network เดียวกับ OpenWebUI แล้วใช้ชื่อ service

  3. ถ้าตั้ง MCPO_API_KEY ไว้ ให้ใส่ key นั้นในช่อง API key
  4. บันทึก แล้วเปิดใช้งานในแชท — โมเดลจะเรียก web_search / fetch_url ได้เอง

ต่อกับ CLI ที่พูด MCP (Claude Code / Cline ฯลฯ)

รันแบบ stdio โดยตรง (ไม่ต้องใช้ mcpo). ติดตั้ง deps ในเครื่องก่อน:

pip install -r mcp/requirements.txt

ตัวอย่าง config (เช่น claude_desktop_config.json หรือ MCP config ของ CLI):

{
  "mcpServers": {
    "web-search": {
      "command": "python",
      "args": ["C:\\Users\\LAPTOP-BACKER\\Code VSTH\\web-search-mcp\\mcp\\server.py"],
      "env": { "SEARXNG_URL": "http://localhost:8080" }
    }
  }
}

ต้องให้ container searxng รันอยู่ (docker compose up -d searxng) เพื่อให้ SEARXNG_URL ใช้งานได้

เพิ่มใน Claude Code ได้ด้วย:

claude mcp add web-search -e SEARXNG_URL=http://localhost:8080 -- python "C:/Users/LAPTOP-BACKER/Code VSTH/web-search-mcp/mcp/server.py"

ปรับแต่ง (env)

ตัวแปรค่าเริ่มต้นความหมาย
SEARXNG_URLhttp://searxng:8080ที่อยู่ SearXNG
HTTP_TIMEOUT20timeout (วินาที)
MAX_RESULTS_CAP20เพดานจำนวนผลลัพธ์
RESEARCH_CONCURRENCY5จำนวนหน้าที่ deep_research ดึงพร้อมกัน
MCPO_API_KEY(ว่าง)API key ของ OpenAPI endpoint

หมายเหตุ

  • ทุกอย่างฟรี ไม่มีค่าใช้จ่าย แต่ SearXNG ดึงจาก engine สาธารณะ — ถ้ายิงถี่มากบาง engine อาจ rate-limit (แก้ได้โดยเปิด/ปิด engine ใน searxng/settings.yml)
  • เปลี่ยน secret_key ใน searxng/settings.yml ก่อนใช้งานจริงเสมอ
Ver o original no GitHub

Bom para

Relacionados