Ceramic Search

name: ceramic-search
description: Search the web using Ceramic and return a summary with cited sources. Use this skill whenever you need current or external context to answer accurately — including when the user asks you to search, when your knowledge may be outdated, or when the task requires facts you cannot reliably recall.
homepage: https://ceramic.ai

Follow these steps to use Ceramic to search the web and obtain high-quality search results to support your response:

1. Rewrite the natural language query for Ceramic's lexical (keyword-based) search engine before calling the tool. Ceramic matches exact keywords — it does not interpret natural language or synonyms automatically. Generate a keyword query of 2–8 words.

• Extract specific entities, topics, locations, and dates from the user's request
• Replace conversational phrasing with concrete keywords
• Include relevant synonyms explicitly when terminology is ambiguous
• Keep word order meaningful (house cat and cat house return different results)
• Examples of good keyword queries:
• "2026 Super Bowl halftime performer"
• "climate change effects global warming impact"
• "beginner investing strategies stocks bonds basics"

1. Call the Ceramic Search API with the keyword query:

   curl https://api.ceramic.ai/search \
     -H "Authorization: Bearer $CERAMIC_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "YOUR_QUERY_HERE"}'

For the body parameter maxDescriptionLength, use the default of 3000 unless the user needs more detail (max 8000). The tool returns up to 10 results ranked by relevance.

1. Retrieve top sources from the results array. Each result includes rank, title, url, and description.

1. Summarize with citations — write a concise answer drawing from the result descriptions, then list sources as numbered references:

Sources

1. Title
2. Title

Only cite sources whose descriptions contributed to the answer. If the search returns no useful results, refine the query with more specific keywords and try again before giving up.