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
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install serply@awesome-codex-pluginsWhat 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-pluginsStep 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