Skip to content

Releases: Aas-ee/open-webSearch

📦 v1.2.0

30 Aug 07:58
@Aas-ee Aas-ee
v1.2.0
f007d02

Choose a tag to compare

View all tags
📦 v1.2.0 Latest
Latest

Release v1.2.0 - Add Configurable Engines and STDIO Mode

🚀 New Features

Configurable Search Engines

  • New Environment Variable: ALLOWED_SEARCH_ENGINES
    • Restrict available search engines by specifying comma-separated engine names
    • Provides better control over which engines can be used in your deployment
    • If the default engine is not in the allowed list, the first allowed engine becomes the default
    • Example: ALLOWED_SEARCH_ENGINES=duckduckgo,bing,exa

Mode Switching Parameters

  • Enhanced MODE Configuration: MODE environment variable now supports three options:
    • stdio - STDIO mode only (ideal for MCP client integration)
    • http - HTTP server mode only (for web-based access)
    • both - Both STDIO and HTTP modes (default behavior)
  • Flexible Deployment: Choose the most appropriate mode for your use case

📋 Configuration Reference

Variable Default Options Description
ALLOWED_SEARCH_ENGINES empty (all available) Comma-separated engine names Limit which search engines can be used
MODE both both, http, stdio Server operation mode

🔧 Usage Examples

Restricted Engine Usage

# Linux/macOS
ALLOWED_SEARCH_ENGINES=duckduckgo,bing DEFAULT_SEARCH_ENGINE=duckduckgo npx open-websearch@latest

# Windows PowerShell
$env:ALLOWED_SEARCH_ENGINES="duckduckgo,bing"; $env:DEFAULT_SEARCH_ENGINE="duckduckgo"; npx open-websearch@latest

Mode-specific Deployments

# STDIO only (for MCP clients)
MODE=stdio npx open-websearch@latest

# HTTP only (for web access)
MODE=http npx open-websearch@latest

# Windows CMD STDIO mode
set MODE=stdio && set DEFAULT_SEARCH_ENGINE=duckduckgo && npx open-websearch@latest
Assets 2
Loading

📦 v1.1.4.2

04 Aug 05:59
@Aas-ee Aas-ee
v1.1.4.2
2506503

Choose a tag to compare

View all tags
📦 v1.1.4.2

📦 v1.1.4.2

Release Date: August 4, 2025 | 发布日期： 2025年8月4日
Tag: v1.1.4.2
Status: Stable / Production Ready

🚀 New Features & Enhancements | 新功能与增强

  • ✅ NPX Quick Start Support | NPX 快速启动支持
    Now supports instant deployment with npx open-websearch@latest - no installation required!
    现在支持使用 npx open-websearch@latest 即时部署 - 无需安装！

  • ✅ Juejin Search & Article Fetching | 掘金搜索与文章获取
    Added support for Juejin (掘金) platform search and full article content extraction
    新增掘金平台搜索支持和完整文章内容提取功能

  • ✅ GitHub README Fetching | GitHub README 获取
    New tool fetchGithubReadme for extracting README content from GitHub repositories
    新增 fetchGithubReadme 工具，用于提取 GitHub 仓库的 README 内容

  • ✅ Enhanced Multi-engine Support | 增强的多引擎支持
    Now includes: Bing, DuckDuckGo, Baidu, CSDN, Exa, Brave, Juejin
    现已包含：Bing、DuckDuckGo、百度、CSDN、Exa、Brave、掘金

  • ✅ Cross-platform Environment Variable Support | 跨平台环境变量支持
    Better Windows PowerShell compatibility and cross-env support for local development
    更好的 Windows PowerShell 兼容性和本地开发的 cross-env 支持

  • ✅ Improved Docker Deployment | 改进的 Docker 部署
    Enhanced Docker configuration with better environment variable handling
    增强的 Docker 配置，更好的环境变量处理

🛠️ Setup Options | 安装选项

  • NPX Quick Start | NPX 快速启动 (npx open-websearch@latest) - NEW! | 新功能！
  • Global Installation | 全局安装 (npm install -g open-websearch)
  • Local Development | 本地开发 (npm install && npm run build)
  • Docker Deployment | Docker 部署 (docker-compose or docker run)
  • Compatible with Claude Desktop, Claude VSCode extension, and Cherry Studio
    兼容 Claude Desktop、Claude VSCode 扩展和 Cherry Studio

🔧 Available Tools | 可用工具

  • search - Multi-engine web search with configurable engines | 可配置引擎的多引擎网络搜索
  • fetchCsdnArticle - Extract full CSDN article content | 提取完整 CSDN 文章内容
  • fetchJuejinArticle - Extract full Juejin article content NEW! | 新功能！
  • fetchGithubReadme - Fetch GitHub repository README files NEW! | 新功能！

📌 Configuration | 配置

Environment Variables | 环境变量:

  • DEFAULT_SEARCH_ENGINE: bing, duckduckgo, exa, brave | 默认搜索引擎
  • USE_PROXY / PROXY_URL: HTTP proxy support | HTTP 代理支持
  • ENABLE_CORS / CORS_ORIGIN: CORS configuration | CORS 配置
  • PORT: Custom server port | 自定义服务器端口

📌 Known Limitations | 已知限制

  • Some engines may block excessive requests (rate limiting)
    某些引擎可能会阻止过多请求（频率限制）
  • Parsing depends on HTML structure of target sites
    解析依赖于目标站点的 HTML 结构
  • IP-based Anti-crawling & JavaScript Challenges | 基于IP的反爬限制与JavaScript挑战
    Different IP types may face varying levels of anti-crawling restrictions and challenges:
    不同IP类型可能面临不同程度的反爬限制和挑战：
    • Cloud server IPs may be more strictly limited, blocked, or face JavaScript challenges (CAPTCHA, bot detection)
      云服务器IP可能受到更严格的限制、封禁，或面临JavaScript挑战（验证码、机器人检测）
  • Not all results include meta info (e.g., description may be missing)
    并非所有结果都包含元信息（例如，描述可能缺失）
  • Personal use only - please comply with search engine terms of service
    仅限个人使用 - 请遵守搜索引擎服务条款

🔄 Migration from v1.1 | 从 v1.1 升级说明

No breaking changes - existing configurations remain compatible. Simply update to the latest version to access new features.
无破坏性更改 - 现有配置保持兼容。只需更新到最新版本即可使用新功能。

Loading

📦 v1.1

10 Jul 08:08
@Aas-ee Aas-ee
v1.1
7a67c08

Choose a tag to compare

View all tags
📦 v1.1

Release Date: July 10, 2025
Tag: v1.1

🚀 What's New

  • ✅ Multi-engine web search support
    Engines: Bing, DuckDuckGo, Baidu, CSDN, Exa, Brave
  • ✅ API key-free usage
    Fully functional without requiring authentication or keys
  • ✅ Proxy support
    Allows configuration of HTTP proxy to bypass regional restrictions
  • ✅ Structured output
    Includes title, URL, and description fields in search results
  • ✅ Default engine configuration
  • ✅ Result limit customization
  • ✅ Article fetching tool for CSDN
    Enables full content extraction from individual articles

🛠️ Setup Options

  • Local: npm install && npm run build
  • Docker: docker-compose or docker run
  • Compatible with: Claude Desktop, Claude VSCode Extension, Cherry Studio
Loading