synthetic-search

Perform zero-data-retention web searches via the Synthetic API with curl and jq.

37|2|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/jpcaparas/skills --skill synthetic-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthetic-search
Source: https://github.com/jpcaparas/skills/tree/main/skills/synthetic-search
Command: npx skills add https://github.com/jpcaparas/skills --skill synthetic-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires SYNTHETIC_API_KEY, jq, node.js, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a streamlined approach to web search using the Synthetic API, offering curl and jq examples, quota checks, and a helper script for readable output, catering to users who need to perform zero-data-retention web searches efficiently.

Core Features & Use Cases

  • Zero-Data-Retention Search: Utilizes the Synthetic API for web search without retaining user data.
  • curl and jq Examples: Provides practical examples for using curl and jq with the Synthetic API.
  • Quota Checks: Offers functionality to check current usage and limits for the Synthetic API.
  • Helper Script: Includes a Node.js script for readable search output and quota summaries.
  • Use Case: Ideal for developers or researchers who need to perform web searches without storing data and require quick access to search results and quota information.

Quick Start

Use the synthetic-search skill to perform a search for "AI development" and view the results in a readable format.

Frequently Asked Questions about synthetic-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform a zero-data-retention web search using curl and jq?

Perform a zero-data-retention web search by using curl to query the Synthetic API and piping the output to jq for structured parsing. This approach ensures no search data is retained while providing readable JSON responses directly in your terminal.

What is the best way to check my Synthetic API search quota?

Check your Synthetic API search quota by running the provided quota check commands. The included Node.js helper script can also summarize current usage and limits, ensuring you stay within your API quota boundaries during web search workflows.

Does the Synthetic API search workflow require Node.js to function?

The Synthetic API search workflow does not strictly require Node.js to function, as core searches use curl and jq. Node.js is an optional dependency used only when you need the helper script for formatting readable search output and quota summaries.

Can I use this Synthetic API approach for web searches without storing user data?

You can use this Synthetic API approach for web searches without storing user data because it is specifically designed for zero-data-retention. It provides curl and jq examples that fetch search results directly without persisting query histories or user payloads.

How do I format Synthetic API web search results for better readability?

Format Synthetic API web search results for readability by piping the curl JSON output through jq. Alternatively, execute the included Node.js helper script to automatically parse and display the search output and quota summaries in a structured format.

What are the limitations of using jq and curl for Synthetic API searches?

Limitations of using curl and jq for Synthetic API searches include manual handling of pagination and lacking built-in rate-limiting logic. Users must manually manage the SYNTHETIC_API_KEY and actively monitor API quota checks to avoid hitting request limits.