Florian Berthold
2e0e8a37d1
Public, curl-based agent skill (Claude Code + Sub-Bots) over the db.exil.es JSON API (https://db.exil.es/api/v1, no auth): - skills/coa-db-skill/SKILL.md — endpoint reference + name->id->detail workflow - bin/coa-db — optional bash helper (search/item/spell/npc/quest/url)
59 lines
1.7 KiB
Bash
Executable file
59 lines
1.7 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
#
|
|
# coa-db — tiny CLI over the public db.exil.es JSON API.
|
|
# No auth required. Pretty-prints with jq when available.
|
|
#
|
|
# Usage:
|
|
# coa-db search <text...> # search items/spells/npcs/quests
|
|
# coa-db item <id>
|
|
# coa-db spell <id>
|
|
# coa-db npc <id>
|
|
# coa-db quest <id>
|
|
# coa-db spells <key=val>... # filter catalogue, e.g. mechanic=15 limit=1000
|
|
# coa-db changes
|
|
# coa-db url <item|spell|npc|quest> <id>
|
|
#
|
|
# Env: COADB_BASE (default https://db.exil.es)
|
|
|
|
set -euo pipefail
|
|
BASE="${COADB_BASE:-https://db.exil.es}"
|
|
API="$BASE/api/v1"
|
|
|
|
_get() { curl -fsS --max-time 20 "$1"; }
|
|
|
|
_pretty() {
|
|
if command -v jq >/dev/null 2>&1; then jq .
|
|
else python3 -m json.tool 2>/dev/null || cat
|
|
fi
|
|
}
|
|
|
|
# URL-encode a string (spaces, &, etc.) without external deps.
|
|
_enc() {
|
|
python3 -c 'import sys,urllib.parse as u; print(u.quote(" ".join(sys.argv[1:])))' "$@"
|
|
}
|
|
|
|
cmd="${1:-}"; shift || true
|
|
case "$cmd" in
|
|
search)
|
|
[ "$#" -ge 1 ] || { echo "usage: coa-db search <text...>" >&2; exit 2; }
|
|
_get "$API/search?q=$(_enc "$@")" | _pretty
|
|
;;
|
|
item) _get "$API/items/${1:?item id}" | _pretty ;;
|
|
spell) _get "$API/spells/${1:?spell id}" | _pretty ;;
|
|
npc) _get "$API/npcs/${1:?npc id}" | _pretty ;;
|
|
quest) _get "$API/quests/${1:?quest id}" | _pretty ;;
|
|
spells)
|
|
q=""; for kv in "$@"; do q="${q:+$q&}$kv"; done
|
|
_get "$API/spells${q:+?$q}" | _pretty
|
|
;;
|
|
changes) _get "$API/changes" | _pretty ;;
|
|
health) _get "$API/health" | _pretty ;;
|
|
url)
|
|
kind="${1:?kind (item|spell|npc|quest)}"; id="${2:?id}"
|
|
echo "$BASE/$kind/$id"
|
|
;;
|
|
*)
|
|
sed -n '2,20p' "$0" | sed 's/^# \{0,1\}//'
|
|
exit 2
|
|
;;
|
|
esac
|