Back to Details

inspiro-best-practices

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Inspiro Best Practices (Bash Only)

Inspiro最佳实践（仅支持Bash）

This skill is Bash-first and requires no Python/JavaScript SDK.
本skill优先基于Bash实现，无需任何Python/JavaScript SDK。

Authentication

认证

Only API key authentication is supported.
bash
export INSPIRO_API_KEY="your_inspiro_api_key"
仅支持API密钥认证。
bash
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.
使用本仓库提供的Bash脚本：
  • skills/inspiro/search/scripts/search.sh
  • skills/inspiro/extract/scripts/extract.sh
  • skills/inspiro/crawl/scripts/crawl.sh
  • skills/inspiro/research/scripts/research.sh
这些脚本会验证输入并直接调用Inspiro REST端点。

Direct API Calls (curl)

直接调用API（curl方式）

Search

搜索

bash
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}'
bash
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

提取

bash
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"]}'
bash
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

爬取

bash
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}'
bash
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

调研

bash
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"}'
bash
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.
  • 将
    INSPIRO_API_KEY
    存放在环境变量或
    ~/.claude/settings.json
    中，切勿在脚本中硬编码。
  • 先使用较小的
    max_results
    /
    limit
    值测试，再逐步扩大规模。
  • 批量执行前务必验证JSON请求体。
  • 若要实现可复现的自动化，优先使用仓库提供的脚本，而非临时编写的单行命令。