Search Skill

Search the web and get relevant results optimized for LLM consumption.

Authentication

This skill only supports API key authentication.

1. Create an account at inspiro.top
2. Generate your API key
3. Add it to ~/.claude/settings.json:

{
  "env": {
    "INSPIRO_API_KEY": "inspiro-your-api-key-here"
  }
}

Only API key authentication is supported.

Quick Start

Using the Script

./scripts/search.sh '<json>'

Examples:

# Basic search
./scripts/search.sh '{"query": "python async patterns"}'

# With options
./scripts/search.sh '{"query": "React hooks tutorial", "max_results": 10}'

# Advanced search with filters
./scripts/search.sh '{"query": "AI news", "time_range": "week", "max_results": 10}'

# Domain-filtered search
./scripts/search.sh '{"query": "machine learning", "include_domains": ["arxiv.org", "github.com"], "search_depth": "advanced"}'

Basic Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "latest developments in quantum computing",
    "max_results": 5
  }'

Advanced Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "machine learning best practices",
    "max_results": 10,
    "search_depth": "advanced",
    "include_domains": ["arxiv.org", "github.com"]
  }'

API Reference

Endpoint

POST https://api.inspiro.top/search

Headers

Header	Value
Authorization	Bearer <INSPIRO_API_KEY>
Content-Type	application/json

Request Body

Field	Type	Default	Description
query	string	Required	Search query (keep under 400 chars)
max_results	integer	10	Maximum results (0-20)
search_depth	string	"basic"	ultra-fast, fast, basic, advanced
topic	string	"general"	Search topic (general only)
time_range	string	null	day, week, month, year
start_date	string	null	Return results after this date (YYYY-MM-DD)
end_date	string	null	Return results before this date (YYYY-MM-DD)
include_domains	array	[]	Domains to include (max 300)
exclude_domains	array	[]	Domains to exclude (max 150)
country	string	null	Boost results from a specific country (general topic only)
include_raw_content	boolean	false	Include full page content
include_images	boolean	false	Include image results
include_image_descriptions	boolean	false	Include descriptions for images
include_favicon	boolean	false	Include favicon URL for each result

Response Format

{
  "query": "latest developments in quantum computing",
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com/page",
      "content": "Extracted text snippet...",
      "score": 0.85
    }
  ],
  "response_time": 1.2
}

Search Depth

Depth	Latency	Relevance	Content Type
ultra-fast	Lowest	Lower	NLP summary
fast	Low	Good	Chunks
basic	Medium	High	NLP summary
advanced	Higher	Highest	Chunks

When to use each:

• ultra-fast: Real-time chat, autocomplete
• fast: Need chunks but latency matters
• basic: General-purpose, balanced
• advanced: Precision matters (default recommendation)

Examples

Domain-Filtered Search

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Python async best practices",
    "include_domains": ["docs.python.org", "realpython.com", "github.com"],
    "search_depth": "advanced"
  }'

Search with Full Content

curl --request POST \
  --url https://api.inspiro.top/search \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "React hooks tutorial",
    "max_results": 3,
    "include_raw_content": true
  }'

Tips

• Keep queries under 400 characters - Think search query, not prompt
• Break complex queries into sub-queries - Better results than one massive query
• Use include_domains to focus on trusted sources
• Use time_range for recent information
• Filter by score (0-1) to get highest relevance results