> For the complete documentation index, see [llms.txt](https://docs-cn.hapigo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-cn.hapigo.com/adv/urlscheme.md).

# API & PopClip 插件

![](/files/VI6fODZ9wWzLOqe5a1GA)

最新版本的 HapiGo 已支持通过 URL Scheme 及 AppleScript 2 种方式来调用 HapiGo。通过这些 API，你可以将其他应用的文本发送到 HapiGo 进行搜索或翻译。如果你是 PopClip 用户，我们也开发了 PopClip 插件，方便你更便捷的操作文本。

### URL Scheme

```url
hapigo://open?extensionID={id}&query={query}
```

其中 query 为关键词变量，extensionID 为扩展的 id。extensionID 部分目前仅开放 4 个内置扩展，后续计划支持全部扩展。4 个内置扩展 id 如下：

* **APP**：发送文本至 HapiGo 应用搜索
* **FILE**：发送文本至 HapiGo 文件搜索
* **CLIPBOARD**：发送文本至 HapiGo 剪贴板搜索
* **TRANSLATE**：发送文本至 HapiGo 翻译

{% hint style="info" %}
当 HapiGo 搜索模式为「混合搜索」时，APP 和 FILE 的效果相同，均为发送文本至主搜索。
{% endhint %}

**URL Scheme 示例**

```css
#在应用模式中搜索「hapigo」：
hapigo://open?extensionID=APP&query=hapigo

#在文件模式中搜索「pdf」：
hapigo://open?extensionID=FILE&query=pdf

#在剪贴板中搜索「request」：
hapigo://open?extensionID=CLIPBOARD&query=request

#在 HapiGo 中翻译「app」：
hapigo://open?extensionID=TRANSLATE&query=app
```

### AppleScript

作为原生应用，HapiGo 也支持使用 AppleScript 调用 HapiGo。打开 AppleScript 脚本编辑器，点击菜单栏「文件」-「打开词典」可以找到 HapiGo 的 AppleScript 语法词典。

![](/files/qkX1THpceo6fYnqwk2zw)

与 URL Scheme 所提供的功能一样，AppleScript 可以在 HapiGo 中搜索应用、文件、剪贴板及进行翻译。

**AppleScript 示例**

```applescript
#在应用模式中搜索「hapigo」：
tell application "HapiGo"
    search app "hapigo"
end tell

#在文件模式中搜索「pdf」：
tell application "HapiGo"
    search file "pdf"
end tell

#在剪贴板中搜索「request」：
tell application "HapiGo"
    search clipboard "request"
end tell

#在 HapiGo 中翻译「app」：
tell application "HapiGo"
    translate "app"
end tell
```

### Popclip 插件

除了提供 URL Scheme 及 AppleScript 接口，我们也开发了现成的 PopClip 插件供大家使用。下载插件后双击安装。此时会在菜单栏 PopClip 图标处弹出 4 个功能选择，分别为：HapiGo 应用搜索、HapiGo 文件搜索、HapiGo 翻译、HapiGo 剪贴板搜索，大家可以根据需要进行选择。后续如需调整，也可以在 PopClip 的插件列表中找到 HapiGo，然后点击后面的齿轮进行设置。

插件的标签描述提供 3 种语言：简体中文、繁体中文、英文。

下载链接：<https://dl.hapigo.com/HapiGoPopClipPlugin.zip>

![](/files/KQiWZIqASaLWvwxUDBF5)