mcpField
O
octen-image-search

octen-image-search

github.com/octen-team创意与媒体1056 次安装4 周前更新
代码仓库

关于 octen-image-search

octen-image-search 是通过文字查询或参考图片查找网络图片的技能，适用于通用图片搜索，并返回缩略图、来源页面、尺寸和描述等信息。目前仅限受邀参与测试。

主要功能

  1. 01按文字或参考图片搜索
  2. 02返回缩略图和来源页面
  3. 03提供图片尺寸与描述
  4. 04按域名筛选结果
  5. 05配置 SafeSearch

适用场景

  1. 01通过文字查找特定主题图片
  2. 02根据参考图查找视觉相关图片
  3. 03将结果限制在指定域名

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/octen-team/octen-skills --skill octen-image-search

安装后在 Claude Code 中输入/octen-image-search确认已加载。

附带文件agents/openai.yaml

详细介绍

Octen 图片搜索

通过文本查询或参考图片在网络上查找图片（每个请求只能接受一种输入）。每条结果都包含缩略图、来源页面、尺寸和描述。

目前处于 Beta 阶段。请联系我们申请 Beta 访问权限。 Octen 图片搜索目前仅限受邀用户使用 — 请通过 https://octen.ai（或 [email protected]）申请访问权限。 未获得访问权限时，调用会失败；如果发生这种情况，请告知用户该功能处于 Beta 阶段，并说明如何联系 Octen。

不适用于 UI 设计参考。 如需参考截图、结构化样式令牌以及用于构建或重新设计前端的 HTML/CSS 代码片段，请使用 octen-design skill（它会使用 topic=design 查询同一端点）。此 skill 用于通用图片搜索。

API 密钥设置

搜索前，请确保已设置 OCTEN_API_KEY。如果收到 401，请停止操作并告知用户需要密钥（https://octen.ai）。如果收到 403，说明密钥有效，但请求遭到拒绝 — 这表示用户可能尚未获得 Beta 访问权限，或账户余额不足；请转达这两种可能性，并说明如何申请 Beta 访问权限。

为相关 Agent 配置密钥（与其他 Octen skills 的配置方式相同）：

  • Claude Code — 将 { "env": { "OCTEN_API_KEY": "your-key" } } 添加到 ~/.claude/settings.json
  • Cursor / 通用 shell — 在 ~/.zshrc 或 ~/.bashrc 中添加 export OCTEN_API_KEY="your-key"
  • Codex — 在 ~/.codex/config.toml 的 [shell_environment_policy] 下添加 set = { OCTEN_API_KEY = "your-key" }
  • OpenClaw — 将 OCTEN_API_KEY=your-key 添加到 ~/.openclaw/.env

端点

POST https://api.octen.ai/image-search

身份验证：X-Api-Key: <API_KEY> 请求头 · Content-Type：application/json

快速开始（cURL）

按文本搜索
curl -s -X POST "https://api.octen.ai/image-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "text", "data": "red sports car"}],
    "count": 5
  }'
按参考图片搜索（URL 或 base64）
curl -s -X POST "https://api.octen.ai/image-search" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: ${OCTEN_API_KEY}" \
  -d '{
    "inputs": [{"type": "image", "url": "https://example.com/car.jpg"}],
    "count": 5
  }'

每个请求的 inputs 只能包含一个条目 — 一个文本查询或一张图片，不能同时包含两者（第二个输入会被拒绝，并返回 400）。对于本地图片，请发送 {"type": "image", "data": "<base64>"}（base64 编码后不超过 5MB；支持 JPEG/PNG 等格式）。

参数

参数类型必填默认值描述
inputs数组是-只能包含一个输入：{"type":"text","data":"<query≤500>"}、{"type":"image","url":"<url>"} 或 {"type":"image","data":"<base64>"}
topic字符串否generalgeneral（网络图片）或 design（UI 设计语料 — 建议使用 octen-design skill）
count整数否5结果数量（1–10）
include_domainsstring[]否-只包含来自这些域名的图片
exclude_domainsstring[]否-排除来自这些域名的图片
safesearch字符串否strict成人内容过滤器：off 或 strict
html_snippet对象否{"enable": false}{enable, max_tokens (默认 5000，100–100000)} — 面向设计的 HTML/CSS 代码片段（主要适用于 topic=design）

此端点不支持时间筛选。time_range、start_time 和 end_time 会被静默丢弃 — 请求仍会返回 200，但结果未经筛选，因此按时间范围进行图片搜索会悄然失效。请在 octen-search 和 octen-video-search 中使用这些参数，这两个端点支持时间筛选。

响应格式

字段类型描述
request_idstring唯一请求标识符
data.results[]array图片结果列表
data.results[].titlestring图片／页面标题
data.results[].urlstring原始尺寸图片 URL
data.results[].thumbnailstring?缩略图 URL
data.results[].source_pagestring?找到图片的页面
data.results[].descriptionstring?描述／替代文本
data.results[].widthinteger?图片宽度（px）
data.results[].heightinteger?图片高度（px）
data.results[].summarystring?结构化风格摘要（主要用于 topic=design）
data.results[].html_snippetstring?HTML/CSS 代码片段（主要用于 topic=design）
data.results[].time_publishedstring?发布时间，ISO 8601
data.results[].time_last_crawledstring?上次抓取时间，ISO 8601
meta.latencynumber响应时间，单位为毫秒
meta.warningstring?警告消息（如有）

错误代码

HTTP 状态码描述
400缺少或参数无效
401API 密钥无效或缺失
403余额不足，或没有 beta 访问权限
413输入过大（经 base64 编码的图片超过 5MB）
429请求过于频繁
500内部服务器错误

注意事项

  • count 上限为 10。
  • 对于UI 设计参考，请改用 octen-design 技能——它会使用 topic=design 封装此端点、下载参考图片，并为你生成设计 summary / html_snippet。

评论

支持 Markdown