inspiro-best-practices（灵感最佳实践）

Inspiro Best Practices (Bash Only)

This skill is Bash-first and requires no Python/JavaScript SDK.

Authentication

Only API key authentication is supported.

export INSPIRO_API_KEY="your_inspiro_api_key"

Recommended Execution Pattern

Use the provided Bash scripts from this repository:

• skills/inspiro/search/scripts/search.sh
• skills/inspiro/extract/scripts/extract.sh
• skills/inspiro/crawl/scripts/crawl.sh
• skills/inspiro/research/scripts/research.sh

These scripts validate inputs and call Inspiro REST endpoints directly.

Direct API Calls (curl)

Search

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

Extract

curl --request POST \
  --url https://api.inspiro.top/extract \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"urls":["https://example.com"]}'

Crawl

curl --request POST \
  --url https://api.inspiro.top/crawl \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"url":"https://docs.example.com","max_depth":1,"limit":20}'

Research

curl --request POST \
  --url https://api.inspiro.top/research \
  --header "Authorization: Bearer $INSPIRO_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"input":"AI agent framework comparison","model":"mini"}'

Operational Tips

• Keep INSPIRO_API_KEY in environment or ~/.claude/settings.json; never hardcode in scripts.
• Use small max_results/limit first, then scale up.
• Always validate JSON request bodies before batch execution.
• For reproducible automation, prefer repository scripts over ad-hoc one-liners.