perplexityai/api-platform-developers
GitHub: perplexityai/api-platform-developers
Perplexity 官方的可移植 Agent Skills 集合，为 Claude Code、Codex CLI 等 AI 编程助手提供 API 迁移与联网搜索技能。
Stars: 67 | Forks: 2
# api-platform-developers
Perplexity API Platform 官方技能，已发布为可移植的 [Agent Skills](https://agentskills.io)。
它们可以在 Claude Code、OpenAI Codex CLI 以及任何其他 Agent Skills 客户端中运行，并且该代码库本身也兼作一个 Claude Code 插件市场。
随着时间的推移，它将不断增加更多的平台技能。
## 安装
### Claude Code
在 Claude Code 内部：
```
/plugin marketplace add perplexityai/api-platform-developers
/plugin install perplexity-platform@api-platform-developers
/reload-plugins
```
或者克隆该代码库并直接加载插件：
```
claude --plugin-dir .
```
使用 `/perplexity-platform:migrate-sonar-to-agent-api [path]` 调用技能。
### Codex CLI 和其他 Agent Skills 客户端
Codex 插件流程（一次安装包含 skills 和 docs MCP）：`codex plugin marketplace add perplexityai/api-platform-developers`，然后从 `/plugins` 中安装 `perplexity-platform`。
或者仅安装技能：
项目范围：将 `skills/` 复制或符号链接到 `/.agents/skills/`。
用户范围：将 `skills/` 复制或符号链接到 `~/.agents/skills/`。
或者使用生态系统安装器：
- `npx skills add perplexityai/api-platform-developers` - 可扩展至约 70 个 agent。
- `gh skill add` - 支持版本固定。
- Codex 的 `$skill-installer` 配合此代码库的 GitHub URL。
在 Codex 中调用：通过描述隐式匹配触发，或使用 `$migrate-sonar-to-agent-api` 显式触发。
### 独立运行（无需插件）
任何能够获取 URL 的 agent 都可以直接使用技能——只需告诉它：
```
Read https://raw.githubusercontent.com/perplexityai/api-platform-developers/main/skills/pplx-cli/SKILL.md, install the skill, and use it for search.
```
（github.com blob URL 也可以；raw URL 会跳过 HTML chrome。）
## 技能目录
| 技能 | 调用方式 | 功能描述 |
|---|---|---|
| migrate-sonar-to-agent-api | `/perplexity-platform:migrate-sonar-to-agent-api [path]` (Claude Code) 或 `$migrate-sonar-to-agent-api` (Codex) | 将代码库从 Sonar chat completions 迁移到 Agent API |
| pplx-cli | `/perplexity-platform:pplx-cli [query or URL]` (Claude Code) 或 `$pplx-cli` (Codex) | 安装并使用 `pplx` CLI 进行实时网络搜索和页面内容抓取 |
安装完成后，技能也会在匹配的上下文中自动触发（例如“帮我从 Sonar 迁移”）。
## Docs MCP server
Agent 可以通过位于 https://docs.perplexity.ai/mcp 的 docs MCP server 在迁移过程中搜索实时的 API 文档。
针对不同客户端的配置方式如下：
- Claude Code：插件会在 `.mcp.json` 中内置它——只需安装该插件即可。独立运行：`claude mcp add --transport http perplexity-docs https://docs.perplexity.ai/mcp`。
- Codex：安装插件（`codex plugin marketplace add perplexityai/api-platform-developers`，然后从 `/plugins` 中安装 `perplexity-platform`）会通过 `.codex-plugin/plugin.json` 捆绑它；该技能也会在 `agents/openai.yaml` 中声明它。对于仅安装技能的情况，你可以在 `~/.codex/config.toml` 中全局添加它：
```
[mcp_servers.perplexity-docs]
url = "https://docs.perplexity.ai/mcp"
```
技能永远不会对其产生硬依赖；它只是一种时效性的增强，而非必要条件。
## 文档
底层的 API 文档位于 [docs.perplexity.ai](https://docs.perplexity.ai)。
## 许可证
基于 [Apache License 2.0](LICENSE) 授权。
标签：AI代理, API集成, Claude, CVE检测, OpenAI, SOC Prime, 代码迁移, 内存规避, 可观测性, 开发工具, 插件市场