技术文档

网络

1. 获取 YouTube 视频信息 (get-youtube-info)

获取 YouTube 视频的详细信息。

{
  "name": "get-youtube-info",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

2. 提取 URL 内容 (extract-url-content)

从指定的 URL 提取 HTML 或其他内容。

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com",
    "selector": "#main-content"
  }
}

3. 搜索 YouTube (search-youtube)

在 YouTube 上搜索视频。

{
  "name": "search-youtube",
  "arguments": {
    "query": "学习编程的技巧",
    "results": 10,
    "filter": "videos"
  }

4. 获取 YouTube 字幕 (get-youtube-subtitles)

获取指定视频的字幕。

{
  "name": "get-youtube-subtitles",
  "arguments": {
    "url": "https://www.youtube.com/watch?v=abc123"
  }
}

AI

5. 生成智能体完成 (generate-agent-completion)

使用 AI 智能体生成完成内容。

{
  "name": "generate-agent-completion",
  "arguments": {
    "prompt": "如何提高我的网站的 SEO？",
    "model": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 500,
    "context": ["这是一个电子商务网站，销售手工制品。"]
  }
}

6. 搜索知识库 (search-knowledge-base)

在指定的知识库中搜索信息。

{
  "name": "search-knowledge-base",
  "arguments": {
    "kbId": "kb_12345",
    "query": "如何优化数据库性能？",
    "limit": 5,
    "similarityThreshold": 0.7
  }
}

开发者工具

7. 执行 JavaScript 代码 (run-js-code)

执行指定的 JavaScript 代码。

{
  "name": "run-js-code",
  "arguments": {
    "code": "const result = [1, 2, 3, 4].reduce((sum, num) => sum + num, 0); console.log(`Sum: ${result}`); return result;",
    "dependencies": {
      "lodash": "^4.17.21"
    },
    "timeout": 5000
  }
}

错误处理

服务器提供强大的错误处理：

• 带有 HTTP 状态码的详细错误消息
• API 密钥验证
• 使用 Zod 方案进行输入验证
• 具有描述性消息的网络错误处理

示例错误响应：

{
  "content": [
    {
      "type": "text",
      "text": "错误：无法获取 YouTube 字幕：404 Not Found"
    }
  ],
  "isError": true
}

开发

# 安装依赖项
npm install

# 启动服务器
node index.js

使用示例

示例 1: 获取网页内容

{
  "name": "extract-url-content",
  "arguments": {
    "url": "https://example.com/blog/post.html",
    "selector": ".article-content"
  }
}

示例 2: 搜索 YouTube 视频

{
  "name": "search-youtube",
  "arguments": {
    "query": "学习人工智能的基础知识",
    "results": 5,
    "filter": "videos"
  }
}

示例 3: 执行计算任务

{
  "name": "run-js-code",
  "arguments": {
    "code": "function factorial(n) { return n <= 1 ? 1 : n * factorial(n - 1); } console.log(factorial(5));",
    "dependencies": {}
  }
}

结论

该 API 提供了丰富的功能，包括网络数据获取、AI 智能体交互和开发者工具支持。通过简单的 JSON 请求即可完成复杂的任务，极大提升了开发效率。