# OttoKit

> 用 Search1API 原生应用，为 OttoKit 工作流添加网页搜索、新闻和网页正文读取。

Canonical URL: https://s1.dev/zh/docs/integrations/ottokit

[OttoKit](https://ottokit.com/integrations/search1api) 的 Search1API 应用让工作流直接联网，不用再手写 HTTP 请求。可以搜索全网或指定网站、查找最新新闻，也能把任意网页变成干净的正文，交给 AI 步骤做摘要。

## 连接

1. 在 [Search1API 控制台](https://app.s1.dev) 的 **API Keys** 页面创建或复制一个 key。
2. 在 OttoKit 工作流里点击 **Add Action**，选择 **Search1API**。
3. 选好动作后，在 **Select Connection** 里点击 **Create New Connection**，把 key 粘贴到 **API Key**。

连接时会用只读的 `/usage` 端点校验 key，不会消耗一次搜索。

## 动作

| 动作 | 作用 |
| --- | --- |
| **Search the Web** | 搜索网页，返回匹配网页的标题、链接和摘要 |
| **Find News** | 按话题查找最新新闻文章 |
| **Read a Web Page** | 读取一个网页，返回标题和干净的正文 |

### Search the Web 和 Find News 的字段

| 字段 | 说明 |
| --- | --- |
| **Search Query** | 要搜索的内容，例如 `EUR/USD outlook`（必填） |
| **Only These Websites** | 用逗号分隔的网站，例如 `fxstreet.com, reuters.com` |
| **Time Range** | 只返回过去一天、一周、一个月或一年的结果 |
| **Number of Results** | 返回多少条结果 |
| **Read Full Text of Top Results** | 同时读取前 N 条结果的全文，方便 AI 步骤做摘要 |
| **Language** | 结果语言代码，例如 `en` 或 `de` |

### Read a Web Page 的字段

| 字段 | 说明 |
| --- | --- |
| **Page URL** | 网页的完整地址，以 `https://` 开头（必填） |

每个字段都可以映射前面步骤的数据。

## 输出

搜索和新闻返回 `results`，每条包含 `title`、`link`、`snippet`，有时还有 `content` 和 `published_date`。Read a Web Page 返回 `results.title`、`results.content` 和 `results.link`。把 `content` 映射给 AI 步骤即可做摘要或分析。

## 积分

搜索和新闻请求各消耗 1 积分；每成功读取一个页面再加 1 积分。新账户无需信用卡即可获得 100 积分。当前价格见[积分与限制](https://s1.dev/zh/docs/essentials/credits-and-limits)。