by 详细分析 ▾
运行时依赖
版本
**Major breaking change: All core source files removed; SKILL.md now includes only documentation and sample code.** - Removed main logic files: ReadResult.js, search.js, exasearch.js, package.json, and config/mcporter.json. - SKILL.md updated to embed sample code and keep documentation only; no executable scripts included. - Usage instructions and error handling sections remain as reference. - Skill now serves as a documentation/sample reference rather than a working implementation.
安装命令 点击复制
技能文档
Perform web searches using various search engines and APIs. This skill provides access to search functionality without requiring API keys for basic usage.
使用各种搜索引擎和API进行网络搜索。此技能提供搜索功能访问，无需API密钥即可进行基本操作。
Features / 功能特性
- URL Content Extraction: Read and extract content from any web page URL
- Keyword Search: Search for specific keywords and return specified number of results
- Dependency Management: Automatic dependency installation via npm
Basic Usage / 基础用法
Read content from a specific URL:
从特定URL读取内容：
node ./search.js [previewLength]
Parameters / 参数:
url: The URL to read (required)
previewLength: Number of characters to preview (optional, default: 200, use 0 to disable preview)
Examples / 示例:
# Default preview (200 characters)
# 默认预览（200字符）
node ./search.js https://www.example.com# Preview 500 characters
# 预览500字符
node ./search.js https://www.example.com 500
# No preview (show only metadata)
# 无预览（仅显示元数据）
node ./search.js https://www.example.com 0
Output Format / 输出格式:
- Title / 标题
- URL
- Platform / 平台
- Content length / 内容长度
- Content preview / 内容预览（可选）
Advanced Usage / 高级用法
Search with specific keyword and result limit:
使用特定关键词和结果限制进行搜索：
node ./exasearch.js [numResults]
Parameters / 参数:
keyword: Search query string (required)
numResults: Number of results to return (optional, default: 10, max: 100)
Examples / 示例:
# Basic search with default 10 results
# 默认10个结果的基础搜索
node ./exasearch.js "artificial intelligence"# Search with 20 results
# 搜索20个结果
node ./exasearch.js "machine learning" 20
# Search with 50 results
# 搜索50个结果
node ./exasearch.js "deep learning" 50
Setup / 安装设置
First-time setup requires installing dependencies:
首次使用需要安装依赖：
Prerequisites / 前置要求:
- Node.js v22 or higher / Node.js v22 或更高版本
- npm or yarn
npm install
Dependencies / 依赖项:
axios: HTTP client for web requests
mcporter: Tool integration framework
Error Handling / 错误处理
The scripts include comprehensive error handling for:
脚本包含全面的错误处理：
- Missing required parameters / 缺少必需参数
- Invalid parameter values / 无效参数值
- Network connection errors / 网络连接错误
- HTTP request failures / HTTP请求失败
- Server timeout errors / 服务器超时错误
Technical Details / 技术细节
- Backend / 后端: Jina Reader API (https://r.jina.ai)
- Timeout / 超时: 15 seconds for web requests / 网络请求15秒
- Output Format / 输出格式: JSON / Markdown
- Search Provider / 搜索提供商: Exa API (via mcporter)
Logic Examples / 逻辑示例
ReadResult.js - Result Object Class
export class ReadResult {
constructor(title, content, url, platform = "web") {
this.title = title;
this.content = content;
this.url = url;
this.platform = platform;
} toDict() {
return {
title: this.title,
content: this.content,
url: this.url,
platform: this.platform
};
}
}
search.js - URL Content Extraction
import axios from 'axios';
import { ReadResult } from './ReadResult.js';class WebChannel {
constructor() {
this.JINA_URL = "https://r.jina.ai/";
}
async read(url) {
try {
const response = await axios.get(${this.JINA_URL}${url}, {
headers: {
'Accept': 'text/markdown'
},
timeout: 15000
});
const text = response.data;
let title = url;
const lines = text.split('\n');
for (const line of lines) {
const trimmedLine = line.trim();
if (trimmedLine.startsWith('# ')) {
title = trimmedLine.substring(2).trim();
break;
}
if (trimmedLine.startsWith('Title:')) {
title = trimmedLine.substring(6).trim();
break;
}
}
return new ReadResult(title, text, url, "web");
} catch (error) {
if (error.response) {
throw new Error(HTTP ${error.response.status}: ${error.response.statusText});
} else if (error.request) {
throw new Error('Network error: No response received');
} else {
throw new Error(Request failed: ${error.message});
}
}
}
}
async function main() {
const url = process.argv[2];
const previewLength = process.argv[3] ? parseInt(process.argv[3], 10) : 200;
if (!url) {
console.error('Usage: node search.js [previewLength]');
console.error(' url: The URL to read');
console.error(' previewLength: Number of characters to preview (optional, default: 200)');
process.exit(1);
}
if (isNaN(previewLength) || previewLength < 0) {
console.error('Error: previewLength must be a non-negative integer');
process.exit(1);
}
const webChannel = new WebChannel();
try {
console.log(Reading: ${url});
const result = await webChannel.read(url);
console.log('\n=== Read Result ===');
console.log(Title: ${result.title});
console.log(URL: ${result.url});
console.log(Platform: ${result.platform});
console.log(Content length: ${result.content.length} characters);
if (previewLength > 0) {
console.log(\nFirst ${previewLength} characters of content:);
const preview = result.content.substring(0, previewLength);
console.log(preview + (result.content.length > previewLength ? '...' : ''));
}
} catch (error) {
console.error('Error reading web page:', error.message);
process.exit(1);
}
}
main();
exasearch.js - Keyword Search
import { callOnce } from "mcporter";async function main() {
const keyword = process.argv[2];
const num = process.argv[3];
if (!keyword) {
console.error('Error: Search keyword is required');
console.error('Usage: node exasearch.js [numResults]');
process.exit(1);
}
const numResults = num ? parseInt(num, 10) : 10;
if (isNaN(numResults) || numResults < 1) {
console.error('Error: numResults must be a positive integer');
process.exit(1);
}
if (numResults > 100) {
console.error('Error: numResults cannot exceed 100');
process.exit(1);
}
try {
console.log(Searching for: ${keyword});
console.log(Number of results: ${numResults});
const result = await callOnce({
server: "exa",
toolName: "web_search_exa",
args: { query: keyword, numResults: numResults },
});
console.log('\n=== Search Results ===');
console.log(JSON.stringify(result, null, 2));
} catch (error) {
console.error('Error during search:', error.message);
if (error.response) {
console.error(HTTP ${error.response.status}: ${error.response.statusText});
} else if (error.request) {
console.error('Network error: No response received from server');
} else if (error.code === 'ECONNREFUSED') {
console.error('Connection refused: Unable to reach the search server');
} else if (error.code === 'ETIMEDOUT') {
console.error('Request timeout: Server took too long to respond');
}
process.exit(1);
}
}
main();
免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制