Skip to main content
plugin CX Codex

serply — Claude Code plugin: what it does, how to install

Teaches your coding agent to fetch Google search, Maps, academic papers, and Reddit discussions or scrape pages to Markdown via Serply.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install serply@awesome-codex-plugins
Open on GitHub

What serply does

The plugin guides an agent through the Serply API and its hosted MCP server. It maps out which endpoint handles each request, covering Google Search, Bing, Scholar, Maps, images, jobs, videos, Reddit, Amazon, and eBay. It also directs agents to convert target web pages straight into clean Markdown.

Under the hood, the skill follows the Agent Skills standard, defining exact parameter schemas and error-prone settings that waste credits. In Codex, a dedicated routing skill directs agent calls to the remote tools while picking up the secret from the runtime environment.

Queries fail without a valid token in the SERPLY_API_KEY environment variable, passed via the X-Api-Key header.

What it helps with

  • retrieve web search results from Google or Bing
  • gather academic citations through Google Scholar
  • scrape live web pages into Markdown
  • query Reddit posts and discussions directly from the agent

Example prompts for the agent

  • Search Google Scholar for recent papers on distributed consensus
  • Scrape this documentation URL and format the text as Markdown
  • Look up troubleshooting threads for this library error on Reddit

How to install serply

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install serply@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about serply

How to install serply in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install serply@awesome-codex-plugins.

What does the serply plugin do?

It equips coding agents with instructions and routing rules to search Google, Scholar, Maps, and marketplaces, or extract page content as Markdown.

How is authentication handled?

Export your API key into SERPLY_API_KEY. The tool forwards it inside the X-Api-Key header without writing it to disk.

Source text

skills · MIT
# Serply Agent Skills

Skills that teach a coding agent how to use the [Serply API](https://serply.io):
which endpoint returns which kind of result, how auth works, the hosted MCP
server's fourteen tools, and the gotchas that cost credits when guessed wrong.

| Skill | What it covers |
|---|---|
| [`searching-with-serply`](skills/searching-with-serply/SKILL.md) | Google Search, Bing, News, Maps, Images, Jobs, Scholar, Video, Amazon, eBay and Reddit results, URL scraping to markdown, and the MCP server |

The skill follows the [Agent Skills](https://agentskills.io/specification)
format, so it works in Claude Code, claude.ai, the Claude API, and any other
client that reads `SKILL.md` files. It is also served at
[serply.io/skill.md](https://serply.io/skill.md).

## Install

With the [`skills`](https://skills.sh) CLI, into the current project or your
user-level skills directory:

```bash
npx skills add serply-inc/skills
```

As a Claude Code plugin:

```bash
claude plugin marketplace add serply-inc/skills
claude plugin install serply@serply-plugins
```

As a Codex plugin, which also registers the hosted Serply MCP server:

```bash
export SERPLY_API_KEY=your_key
codex plugin marketplace add serply-inc/skills
codex plugin add serply@serply-plugins
```

The Codex plugin bundles its own `serply-mcp` skill
([`codex/skills/serply-mcp`](codex/skills/serply-mcp/SKILL.md)) that routes each
request to the right MCP tool. Codex reads the key from `SERPLY_API_KEY` at
runtime ([`codex.mcp.json`](codex.mcp.json)); it is never written to disk.

Or copy the file by hand:

```bash
mkdir -p .claude/skills/searching-with-serply
curl -o .claude/skills/searching-with-serply/SKILL.md https://serply.io/skill.md
```

You also need a Serply API key, set as an environment variable and passed in
the `X-Api-Key` header. New accounts get 2,500 free credits with no card at
[app.serply.io/users/sign_up](https://app.serply.io/users/sign_up).

## Aeon

[`aeon/`](aeon) is a community skill pack for the
[Aeon](https://github.com/aeonfun/aeon) agent framework. Its `serply-search`
skill runs Google web or news searches and sends a cited digest through Aeon's
`./notify`:

```bash
bin/install-skill-pack serply-inc/skills --path aeon
```

## Verifying

Every endpoint, parameter and response shape the skill describes was checked
against the live API. To validate the skill file against the specification:

```bash
uvx --from skills-ref agentskills validate skills/searching-with-serply
```

## Related

- [Agent Skill guide](https://serply.io/docs/guides/agent-skill) on serply.io
- [Serply MCP server](https://github.com/serply-inc/mcp), the hosted server the skill points agents at
- [API reference](https://serply.io/docs)

## License

MIT. See [LICENSE](LICENSE).

© Serply · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Browser and scraping →

From the same set391

The whole set →
solidworks-gpt-plugin The solidworks-gpt-plugin plugin for Claude Code uses five skills to take SolidWorks work from requirements through modeling to a measured, validated model and session report. CX Codex ★ 1,596repo stars solidping Connects Claude Code to SolidPing through a remote MCP server to monitor service uptime, inspect incidents, and update status pages. CX Codex ★ 1,596repo stars svatlas svatlas is a Claude Code plugin that searches profiles of AI startups and founders, then matches companies to a product. It also manages prospect lists. CX Codex ★ 1,596repo stars shots Renders App Store screenshots and icons from the code already in your repo, then handles locale translation and ASO copy edits without leaving the agent. CX Codex ★ 1,596repo stars sendsets sendsets is a Claude Code and Codex plugin for managing cold email through Sendsets. It connects mailboxes, builds outbound sequences, launches campaigns, and handles replies through MCP. CX Codex ★ 1,596repo stars sendpaper sendpaper lets an agent order real postcards and letters to US addresses, showing a print preview and asking before any payment goes through. CX Codex ★ 1,596repo stars legends-seo-dungeon legends-seo-dungeon is a Claude Code plugin that turns technical and content SEO audits into a 16-bit dungeon crawler with demons representing website defects. CX Codex ★ 1,596repo stars self-starter The self-starter plugin for Claude Code and Codex monitors plain-language event conditions in the background and resumes a task in the conversation when one is met. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open