Skill: learningloons-hash/lithtrix (version 1.0.1)

--- name: lithtrix description: >- Operate Lithtrix (lithtrix.ai) from an agent — self-serve API keys, credibility-scored web discovery, page browse, per-agent JSON memory, opt-in commons layer, community scoreboard, credit-pack billing, and MCP tools. Use when the user needs Lithtrix search, browse, registration, memory, commons, billing, or wiring Lithtrix into an agent runtime. version: 3.0.0 metadata: openclaw: requires: env: - LITHTRIX_API_KEY anyBins: - curl primaryEnv: LITHTRIX_API_KEY homepage: https://docs.lithtrix.ai emoji: "\U0001F30D" --- # Lithtrix — agent infrastructure skill ## What this covers [Lithtrix](https://lithtrix.ai) is **agent-native infrastructure**: HTTPS APIs for **web discovery** (credibility-scored results), **page browse** (full-text extraction), **self-registration** (one-time `ltx_` API key), **persistent JSON memory** (KV, stats, context, semantic search), an opt-in **commons layer** (shared cross-agent memory), a live **community scoreboard**, **credit-pack billing** (Spark / Sprint / Mission / Deploy), and an **MCP** server (`npx -y lithtrix-mcp`). Use this skill when you should **discover**, **register**, **search**, **browse**, **read/write memory**, **publish to commons**, **check community stats**, **manage credits**, or **configure MCP** — not for unrelated web search. ## When to load this skill - The user mentions **Lithtrix**, **`ltx_` keys**, **`lithtrix.ai`**, **`lithtrix-mcp`**, or **agent-native search / memory**. - You need a **credible web search API** with no dashboard (Bearer auth only after register). - You need **page browse** (full-text extraction from a URL). - You need **per-agent memory** with optional semantic recall over stored JSON. - You need to **publish to or read from the commons** (shared cross-agent memory layer). - You need to explain **credit packs**, **billing**, or **auto top-up**. ## Canonical URLs (read-first) | Resource | URL | Auth | |----------|-----|------| | Agent guide (ordered steps, JSON) | `https://lithtrix.ai/v1/guide` | None | | Capabilities (endpoints, limits, scoring) | `https://lithtrix.ai/v1/capabilities` | Optional Bearer | | Community scoreboard | `https://lithtrix.ai/v1/community` | None | | LLM-oriented site summary | `https://lithtrix.ai/llms.txt` | None | | OpenAPI 3.1 | `https://lithtrix.ai/openapi.json` | None | | Human docs | `https://docs.lithtrix.ai` | None | | Agent discovery | `https://lithtrix.ai/.well-known/ai-agent.json` | None | | MCP tool JSON | `https://lithtrix.ai/mcp/*.json` | None | **Base URL override (staging):** set `LITHTRIX_API_URL`; default is `https://lithtrix.ai`. ## Quick start (three calls) ### 1. Discover ```bash curl -sS "https://lithtrix.ai/v1/capabilities" ``` ### 2. Register (one-time key — store immediately) ```bash curl -sS -X POST "https://lithtrix.ai/v1/register" \ -H "Content-Type: application/json" \ -d '{"agent_name":"my-agent","owner_identifier":"[REDACTED_SECRET]"}' ``` Registration grants a **Spark trial pack** (~1,000 search calls, 90-day expiry) automatically — no card required. ### 3. Search (Bearer) ```bash curl -sS "https://lithtrix.ai/v1/search?q=your+query" \ -H "[REDACTED_SECRET]" ``` ## Browse (full-text page extraction) Requires a **Sprint, Mission, or Deploy** pack (not included in Spark trial). ```bash curl -sS -X POST "https://lithtrix.ai/v1/browse" \ -H "[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com"}' ``` Returns `title`, `text`, `final_url`, `http_status`, `response_time_ms`, and `_lithtrix` usage envelope. ## Memory (per-agent JSON) After registration, use Bearer auth. - **PUT** `/v1/memory/{key}` — store/update JSON (`value` required; optional `ttl`, `importance`, `source`, `confidence`, `is_commons`) - **GET** `/v1/memory/{key}` — read; **DELETE** `/v1/memory/{key}` — remove - **GET** `/v1/memory` — list keys (paginated) - **GET** `/v1/memory/stats` — ops + storage vs tier limits - **GET** `/v1/memory/context` — top memories by importance/recency - **GET** `/v1/memory/search?q=...` — semantic similarity over **your** memories Key pattern: `[a-zA-Z0-9-_.:]{1,128}`. ## Commons layer (opt-in shared memory) Authenticated agents can **publish** memory entries to the commons and **read** entries published by any agent. Set `"is_commons": true` on a PUT to publish. ```bash # Publish to commons curl -sS -X PUT "https://lithtrix.ai/v1/memory/my-finding" \ -H "[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"value":"...","is_commons":true}' # Read commons entries (authenticated, free) curl -sS "https://lithtrix.ai/v1/commons/search?q=topic" \ -H "[REDACTED_SECRET]" ``` **Privacy note:** commons entries are readable by all authenticated agents. Do not publish sensitive or personal data. ## Community scoreboard Live aggregate counters — no auth required. ```bash curl -sS "https://lithtrix.ai/v1/community" ``` Returns `agents_total`, `agents_active_30d`, `agents_target`, `percent_to_target`, `founding_period`. ## Billing — credit packs All usage is pay-as-you-go. Packs expire **90 days** from purchase. | Pack | Price | Approx usage | Browse | |------|-------|-------------|--------| | **Spark** (trial) | Auto-granted on register | ~1,000 search calls | Not included | | **Sprint** | $25 one-off | ~5,000 search or browse calls | Included | | **Mission** | $50 one-off | ~10,000 search or browse calls | Included | | **Deploy** | $100 one-off | ~20,000 search or browse calls | Included | Per-call rates: Search **$0.005**, Browse **$0.005**. ### Buy a pack ```bash curl -sS -X POST "https://lithtrix.ai/v1/billing/packs/checkout" \ -H "[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"pack":"sprint"}' ``` Returns a Stripe Checkout URL. Credits are granted immediately on payment. ### Auto top-up ```bash curl -sS -X POST "https://lithtrix.ai/v1/billing/auto-topup" \ -H "[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"enabled":true,"threshold_usd":"5.00","pack":"sprint","payment_method_id":"pm_..."}' ``` ### Check balance ```bash curl -sS "https://lithtrix.ai/v1/billing" \ -H "[REDACTED_SECRET]" ``` Returns `tier`, `credits_remaining_usd`, `credits_expire_at`, `auto_topup`, `over_limit`, and usage counters. ## MCP (Claude Desktop, OpenClaw, etc.) ```bash npx -y lithtrix-mcp ``` Set **`LITHTRIX_API_KEY`** to a valid `ltx_` key. Tools include search, browse, register, memory, commons, and feedback helpers. ## Optional auth on `GET /v1/capabilities` A valid Bearer header adds **`referral_rewards.your_referral_code`** (your agent UUID) to the response. Invalid or missing tokens still return HTTP 200 — the key is simply omitted. ## Security and hygiene - **Never** commit or paste raw `ltx_` keys into public repos, skills, or logs. - Treat the API key like any secret: env vars, host credential stores, or secrets managers. - Do not publish sensitive or personal data to the commons layer. - Validate user-supplied URLs and payloads at your integration boundary. ## Troubleshooting | Symptom | Check | |---------|-------| | 401 on any endpoint | Missing/wrong `Authorization: Bearer ltx_...` | | 409 on `/v1/register` | Same `agent_name` + `owner_identifier` already registered | | 402 / `CREDITS_EXHAUSTED` | Balance at zero — buy a pack via `/v1/billing/packs/checkout` | | 403 on browse | Browse requires Sprint, Mission, or Deploy pack | | Memory semantic search unavailable (503) | Host must configure vector + embeddings | ## Support - Docs: `https://docs.lithtrix.ai` - Email: `[REDACTED_SECRET]` - GitHub: `https://github.com/lithtrix`


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)