choose-your-parallel-api SKILL.md skillA

choose-your-parallel-api from parallel-web/parallel-agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add parallel-web/parallel-agent-skills/choose-your-parallel-api@git:20260914.320a706

Pins git:20260914.320a706 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
parallel-web/parallel-agent-skills
Path
skills/choose-your-parallel-api/SKILL.md
Versions recorded
1
Latest version
git:20260914.320a706, committed Sep 14, 2026
Size
18,633 bytes
Repository stars
90
License
MIT

Choose the right Parallel API and configuration for cost, latency, and answer quality. Use when adding live web data to an app: current events and prices, a cited answer in a chat, grounding an agent in sources it can read in full, reading a URL or PDF, deep research reports, researching or enriching every row of a list or CRM. Use when picking among Search and Extract, Responses, and Task, or when choosing a search mode, reasoning effort, or Task processor. Also use when an integration is too…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Choose the right Parallel API and configuration

This skill covers four Parallel APIs for adding web data to an app. Search finds pages, Extract reads them,
Responses answers a question, Task fills a schema.

**Search and Extract are one pattern, not two choices.** Search locates the pages
and returns excerpts; Extract returns the full content of the ones worth reading.
Most agent integrations want both.

Choose once, while writing the integration — not on every request. A live
classifier in the request path buys flexibility nobody asked for and charges a
model round-trip for it on every call. Decide here; hard-code the result.

Most disappointing results come from choosing the wrong API or configuration, not
from the underlying quality: the right API at the wrong tier, or the right tier
with the wrong knobs. Choose the API first, tier second, knobs third — in that order.

## Setup

`PARALLEL_API_KEY` is the connection secret, server side.

## Step 1 — Know the available surface

```text
POST /v1/search                          # find pages
POST /v1/extract                         # read pages
POST /v1/responses                       # cited answer, synchronous
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add parallel-web/parallel-agent-skills/choose-your-parallel-api@sha256:752cefd7f0faa9f5

The line at the top of this page pins the label git:20260914.320a706, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_zte5r7gpgic25nw4.svg)](https://markdownregistry.com/a/art_zte5r7gpgic25nw4)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 14, 2026.

versioncommittedcommitsizeaudit
git:20260914.320a706 latest2026-09-14 320a706 18,633 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (18633 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

parallel-web/parallel-agent-skills · 90 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_zte5r7gpgic25nw4
GET https://markdownregistry.com/api/v1/resolve?ref=parallel-web/parallel-agent-skills/choose-your-parallel-api
GET https://markdownregistry.com/api/v1/blob/752cefd7f0faa9f535598347150d77d8ca9a5491d40986bc6439e41344e7c7e4

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from parallel-web/parallel-agent-skills

migrate-to-parallel SKILL.md skill
parallel-web/parallel-agent-skills · skills/migrate-to-parallel/SKILL.md · Migrate Exa, Tavily, Perplexity, or Firecrawl web-data integrations completely to the appropriate Parallel products…
git:20260714.74ec62e · audit A · 90 stars
parallel-cli-setup SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-cli-setup/SKILL.md · Set up and maintain the Parallel CLI (install, auth, balance, skills install)
git:20261005.41c7730 · audit A · 90 stars
parallel-data-enrichment SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-data-enrichment/SKILL.md · Bulk data enrichment. Adds web-sourced fields (CEO names, funding, contact info) to lists of companies, people, or…
git:20260925.8fc1fc4 · audit A · 90 stars
parallel-deep-research SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-deep-research/SKILL.md · ONLY use when user explicitly says 'deep research', 'exhaustive', 'comprehensive report', or 'thorough investigation'…
git:20260925.8fc1fc4 · audit A · 90 stars
parallel-findall SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-findall/SKILL.md · Discover entities (companies, people, products, etc.) matching a natural-language description. Use when the user asks…
git:20260925.8fc1fc4 · audit A · 90 stars
parallel-mcp-setup SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-mcp-setup/SKILL.md · Use when installing, configuring, or troubleshooting an authenticated Parallel Search MCP connection in Bifrost…
git:20260917.26574f4 · audit A · 90 stars
parallel-memory SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-memory/SKILL.md · Recall past Parallel Task, Monitor, and FindAll runs when they may help; evict runs or clear memory when asked.
git:20260810.8f0f0df · audit A · 90 stars
parallel-monitor SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-monitor/SKILL.md · Continuously track the web for changes on a recurring cadence. Use when the user asks to 'monitor', 'track changes to'…
git:20260925.8fc1fc4 · audit A · 90 stars
parallel-search-setup SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-search-setup/SKILL.md · Use when verifying, using, or troubleshooting the anonymous Parallel Search MCP server bundled with this plugin — when…
git:20260922.b8f121b · audit A · 90 stars
parallel-web-extract SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-web-extract/SKILL.md · CLI-backed URL extraction. Use when the user explicitly invokes this skill, needs CLI-only controls or saved JSON…
git:20260925.8fc1fc4 · audit A · 90 stars
parallel-web-search SKILL.md skill
parallel-web/parallel-agent-skills · skills/parallel-web-search/SKILL.md · CLI-backed web search. Use when the user explicitly invokes this skill, needs CLI-only controls or saved JSON output…
git:20260925.8fc1fc4 · audit A · 90 stars
result SKILL.md skill
parallel-web/parallel-agent-skills · skills/result/SKILL.md · Get completed research task result by run ID
git:20260519.b667820 · audit A · 90 stars

Every file in parallel-web/parallel-agent-skills

Browse by kind, by grade A, or by owner.