Keep me
", "mode": "markdown" } ``` Returns stripped text or markdown. Scripts and styles are dropped. ## Doc: https://grokzilla.shop/docs/json-flatten # JSON Flattener Deterministic nested JSON → flat path-value map. First-party on grokzilla.shop. ## Call `POST /api/skills/json-flatten` ```json { "data": { "user": { "id": 7, "tags": ["a", "b"] } }, "options": { "separator": ".", "arrayStyle": "index", "maxDepth": 20 } } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Price: $0.01 per call. ## Doc: https://grokzilla.shop/docs/json-schema-validate # JSON Schema Validator POST `/api/skills/json-schema-validate` — $0.006 USDC on Base. ```json { "instance": { "id": 1 }, "schema": { "type": "object", "required": ["id"], "properties": { "id": { "type": "number" } } } } ``` Use this as a cheap gate before paying a larger model. `ok` means the check ran. `valid` means the instance matched the schema. An invalid instance is `ok: true`, `valid: false`, with `errors` filled. `ok: false` means the schema could not be checked (it is not an object, or a nested schema keyword is the wrong type). ## Doc: https://grokzilla.shop/docs/json-sort # JSON Key Sorter Recursively sort object keys and return canonical compact JSON. Deterministic, no network. First-party on grokzilla.shop. ## Call `POST /api/skills/json-sort` ```json { "data": { "b": 1, "a": { "d": 2, "c": 3 } }, "reverse": false } ``` `data` (required, any JSON), `reverse` (optional boolean, default `false`). ## Response (paid 200) ```json { "skill": "json_sort", "ok": true, "sorted": { "a": { "c": 3, "d": 2 }, "b": 1 }, "canonical": "{\"a\":{\"c\":3,\"d\":2},\"b\":1}", "bytes": 25 } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call. ## Doc: https://grokzilla.shop/docs/keyword-extract # Keyword Extractor POST `/api/skills/keyword-extract` — $0.008 USDC on Base. ```json { "text": "Agents pay per call with USDC on Base using the x402 protocol.", "limit": 10 } ``` Stopword-filtered term ranking. Deterministic. ## Doc: https://grokzilla.shop/docs/nicje # NICJE Data Refinery Taking messy data, making it agent-kind. Native x402 skill on this marketplace. Does not replace other skills. ## Step 1 — Quick test ```bash curl -s -X POST https://x402-micro-pay.com/api/skills/nicje \ -H "Content-Type: application/json" \ -d '{"recipe":"eval_set","request":"prepare a clean evaluation set","raw":"id,name,value\n1,a,2.5\n2,b,5\n2,b,5"}' ``` Unpaid calls return **HTTP 402** with `PAYMENT-REQUIRED`. Pay USDC on Base to the catalog `pay_to`, then retry. ## Step 2 — Recipes | recipe | price | output | |--------|-------|--------| | eval_set | $0.02 | Stratified sample + schema contract. Copies `expected`, else `output`, `label`, `answer`, or `value`, onto each item as `expected` (`0` and `""` count). | | rag_chunks | $0.02 | Token-aware chunks for retrieval | | custom | $0.02 | Swarm classifies the real need | ## Step 3 — Surfaces - Human UI on this domain: https://x402-micro-pay.com/nicje - Dedicated host: https://nicje-x402.vercel.app - Catalog: `GET /api/catalog` (skill id `nicje`) ## Input schema | Field | Type | Required | |-------|------|----------| | raw | string | yes | | request | string | no | | recipe | string | no (default eval_set) | ## Doc: https://grokzilla.shop/docs/osint-graph # Public OSINT Graph Resolves one public name on Wikidata and returns a relationship graph from a fixed property list (instance of, country, headquarters, founder, chief executive, ownership, employer, education, membership, and similar). Hops stop at 2. People include only notable public roles: employer, education, position, and membership. Family, addresses, and contact details are not returned. If nothing matches, `graph` is empty and `reason` says why. No confidence score is returned. ## Step 1 — Quick test ```bash curl -s -X POST https://x402-micro-pay.com/api/skills/osint-graph \ -H "Content-Type: application/json" \ -d '{"seed_entity":"OpenAI","max_depth":2}' ``` ## Step 2 — Agent client ```bash python -m agent.humanless_client osint_graph --seed "OpenAI" --depth 2 ``` ## Input schema | Field | Type | Required | |-------|------|----------| | seed_entity | string | yes | | max_depth | integer (1–4 accepted; values above 2 run as 2) | no, default 2 | An empty or missing seed is rejected (HTTP 400, or the request validator). The seed is not replaced with a sample. ## Output `skill`, `seed_entity`, `max_depth`, `limit`, `disclaimer`, `resolved`, `alternatives` (up to three Wikidata candidates), `graph.nodes` (`id`, `name`, `type`, `url`), `graph.edges` (`from`, `to`, `relation`, `pid`), `degrees_sample` (shortest paths that use those edges), and `sources`. `reason` is present when the seed did not match or a Wikidata call failed. ## Billing Paid per call. The price is the `osint_graph` entry in `/api/catalog`. ## Doc: https://grokzilla.shop/docs/pii-redact # PII Redactor Replace personal data in free text with typed placeholders. Deterministic, regex-based, no network. First-party on grokzilla.shop. ## Call `POST /api/skills/pii-redact` ```json { "text": "Mail jane@example.com or call 555-123-4567." } ``` `text` (required string, up to 400,000 characters). | Type | Placeholder | Matches | |---|---|---| | email | `[EMAIL]` | `name@domain.tld` | | ipv4 | `[IPV4]` | dotted quads with octets 0-255 | | card | `[CARD]` | 13-19 digits (spaces or dashes allowed) that pass the Luhn check | | ssn | `[SSN]` | SSN-shaped `123-45-6789` / `123 45 6789` | | phone | `[PHONE]` | US formats like `(312) 555-0199`, `555.123.4567`, `+1 555 123 4567`, and `+`-prefixed international numbers (10-15 digits) | This is pattern matching, not a guarantee: names and street addresses are not detected, and numbers that look like the shapes above are redacted. ## Response (paid 200) ```json { "skill": "pii_redact", "ok": true, "redacted": "Mail [EMAIL] or call [PHONE].", "counts_by_type": {"email": 1, "ipv4": 0, "card": 0, "ssn": 0, "phone": 1}, "total": 2 } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call. ## Doc: https://grokzilla.shop/docs/research # Deep Research Searches Wikipedia (opensearch and full-text), Hacker News (Algolia), and DuckDuckGo when reachable, fetches the top public pages, and returns a cited answer from those pages. The answer is extractive (sentences copied from the pages) unless `OPENROUTER_API_KEY` is set, in which case an OpenRouter model may write the answer from that same text. If nothing can be fetched, `sources` is empty and `reason` says why. No confidence score is returned. ## Step 1 — Quick test ```bash curl -s -X POST https://x402-micro-pay.com/api/skills/research \ -H "Content-Type: application/json" \ -d '{"query":"What is x402?"}' ``` ## Step 2 — Agent client ```bash python -m agent.humanless_client research "What is x402?" ``` ## Step 3 — Applet + model 1. Open `/applet` 2. Pick your model provider and paste API key (stored locally) 3. Write a research question in **Service prompt** 4. Paste background docs in **Context window** 5. **Call model + service** to get structured JSON + model explanation ## Input schema | Field | Type | Required | |-------|------|----------| | query | string | yes | An empty or missing query is rejected (HTTP 400, or the request validator). The query is not replaced with a sample. Send a question ("What is x402?") or a topic ("x402 protocol", answered as "what is x402 protocol"). Creative or generative requests ("write a poem about…", "generate a short story…") are refused with HTTP 400 `unsupported_query` before any payment, so nothing is charged. ## Output `skill`, `query`, `answer`, `key_points`, `sources` (`n`, `title`, `url`, `snippet`), `method` (`extractive` or `llm`), and `fetched_at`. Citations in the answer look like `[1]`. `sources` lists only the pages the answer cites, numbered to match the citations. ## Doc: https://grokzilla.shop/docs/seo # SEO Optimizer Fetches a public URL through the SSRF-safe client and returns an on-page SEO score from real checks (title, meta description, headings, image alt text, keywords, and more). If the page cannot be fetched, `score` is null and `reason` says why. ## Step 1 — curl ```bash curl -s -X POST https://x402-micro-pay.com/api/skills/seo \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com","keywords":["x402","agents"]}' ``` ## Step 2 — Agent ```bash python -m agent.humanless_client seo --url https://example.com ``` ## Step 3 — Tutorial workflow 1. Run SEO on your landing page URL 2. Apply top recommendations (failed checks, highest weight first) 3. Re-run and compare `score` ## Doc: https://grokzilla.shop/docs/sha256 # SHA-256 Hash Hash a string with SHA-256 and return hex plus a short prefix. Deterministic, no network. First-party on grokzilla.shop. ## Call `POST /api/skills/sha256` ```json { "text": "hello", "encoding": "utf-8" } ``` `text` (required string), `encoding` (optional: `utf-8` default, `utf8`, `ascii`). ## Response (paid 200) ```json { "skill": "sha256", "ok": true, "algo": "sha256", "bytes": 5, "hex": "2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824", "hex_prefix": "2cf24dba5fb0a30e" } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call. ## Doc: https://grokzilla.shop/docs/slugify # Slugify Turn free text into a URL-safe lowercase slug. Deterministic, no network. First-party on grokzilla.shop. ## Call `POST /api/skills/slugify` ```json { "text": "Hello, Grokzilla Shop!", "max_len": 80 } ``` `text` (required string), `max_len` (optional integer 1-200, default 80). Accented letters fold to ASCII (`Café Déjà Vu` → `cafe-deja-vu`, `Straße` → `strasse`). Letters the fold does not cover are transliterated (`ß`→`ss`, `æ`→`ae`, `ø`→`o`, `ł`→`l`, `đ`→`d`). Text with no letters or digits returns an empty `slug`, `empty: true`, and a `reason`. That response is still `ok: true`. ## Response (paid 200) ```json { "skill": "slugify", "ok": true, "slug": "hello-grokzilla-shop", "chars": 20, "empty": false } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call. ## Doc: https://grokzilla.shop/docs/text-diff # Text Diff Line / word / char diff with structured or unified output. ## Call `POST /api/skills/text-diff` ```json { "a": "hello world", "b": "hello grokzilla", "options": { "mode": "words", "format": "structured" } } ``` Unpaid → HTTP 402. Price: $0.01 per call. ## Doc: https://grokzilla.shop/docs/token-count # Token Counter POST `/api/skills/token-count` — $0.004 USDC on Base. ```json { "text": "Budget this prompt before the expensive hop.", "encoding": "cl100k" } ``` Approximate cl100k / o200k counts for spend decisions. ## Doc: https://grokzilla.shop/docs/token-risk # Token Risk (Base) Heuristic risk checks for an ERC-20 token on Base mainnet before an agent buys or sells it: honeypot and transfer-tax simulation against the deepest pool, plus contract, metadata, proxy, owner and privileged-function checks. Read-only: every check is a JSON-RPC read against a free public Base endpoint (mainnet.base.org, then base-rpc.publicnode.com, then base.drpc.org). Nothing is signed or broadcast, and no paid data provider is called. **Informational only, not financial advice.** The checks run at one block and can miss risks or flag legitimate tokens. ## Call `POST /api/skills/token-risk` ```json {"token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"} ``` `token` (required): the token contract address (`0x` + 40 hex). `chain` (optional): only `"base"` for now. ## Checks Each check is `{"result": "pass" | "warn" | "fail" | "unknown", "evidence": {...}}`. A check that could not run is `unknown` with a `reason`; it is never reported as a pass. | Check | What it does | warn / fail when | |---|---|---| | `contract_code` | `eth_getCode` | fail: no code at the address | | `erc20_metadata` | `name`, `symbol`, `decimals`, `totalSupply` | fail: none readable | | `proxy` | EIP-1967 and legacy zeppelinos implementation/admin slots | warn: upgradeable proxy | | `ownership` | `owner()` / `getOwner()` | warn: owner still set; pass: `0x0` or `0x…dEaD` | | `privileged_functions` | PUSH4 selectors in the token's (and implementation's) bytecode: mint, blacklist, pause, fee setters, trading switches / limits | warn: any found (presence only, not who may call them) | | `liquidity_pool` | Uniswap v2 `getPair`, Uniswap v3 `getPool` (fees 100/500/3000/10000), Aerodrome `getPool` (volatile/stable) against WETH and USDC; the pool holding the most of the token is used | warn: thin quote-side liquidity | | `sell_simulation` | `eth_simulateV1`: a holder (balance planted with a state override after locating the balance storage slot) transfers 0.1% of the pool's balance into the pool, the token-side leg of a sell | fail: reverts, returns false, or delivers nothing | | `buy_simulation` | the same amount transferred out of the pool, the token-side leg of a buy | same as above | | `transfer_tax` | `1 − received / sent` for both legs, from `balanceOf` before and after | warn ≥ 1%, fail > 10% | A Uniswap quoter is not used for tax: it quotes the pool's math, not what a fee-on-transfer token actually delivers, so the token transfer is measured directly. AMM fees are not included. `risk_level`: any fail → `high`; else any warn → `medium`; else any unknown → `unknown`; else `low`. One exception: an unreadable owner on a token with no privileged selectors (for example WETH) does not block `low`. `reasons` lists what drove the level. ## Errors (not charged) - `422 invalid_params`: missing or malformed `token`, `chain` other than `"base"`. - `400 invalid_token`: zero or dead address. - `502 upstream_error`: no public Base RPC answered. ## Response (paid 200, USDC) USDC is `medium` because it is an upgradeable proxy with an active owner and mint, blacklist and pause functions. Those are real controls, even though the token is a regulated stablecoin. ```json { "skill": "token_risk", "ok": true, "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "chain": "base", "chain_id": 8453, "block": 52494540, "symbol": "USDC", "risk_level": "medium", "reasons": [ "proxy: warn", "ownership: warn", "privileged_functions: warn" ], "checks": { "contract_code": { "result": "pass", "evidence": { "bytecode_bytes": 1852, "block": 52494540 } }, "erc20_metadata": { "result": "pass", "evidence": { "name": "USD Coin", "symbol": "USDC", "decimals": 6, "total_supply": "4419304031200909", "missing": [] } }, "proxy": { "result": "warn", "evidence": { "standard": "zeppelinos (legacy unstructured storage)", "implementation": "0x2ce6311ddae708829bc0784c967b7d77d19fd779", "admin": "0x4fc7850364958d97b4d3f5a08f79db2493f8ca44", "note": "upgradeable: whoever controls the proxy can replace the token's code" } }, "ownership": { "result": "warn", "evidence": { "function": "owner()", "owner": "0x3abd6f64a422225e61e435bae41db12096106df7", "renounced": false } }, "privileged_functions": { "result": "warn", "evidence": { "found": { "mint": [ "configureMinter(address,uint256)", "mint(address,uint256)" ], "blacklist": [ "blacklist(address)", "isBlacklisted(address)" ], "pause": [ "pause()", "unpause()" ] }, "scanned": [ "token", "implementation" ], "note": "selector presence only; who may call them is not checked" } }, "liquidity_pool": { "result": "pass", "evidence": { "dex": "uniswap_v3", "variant": "fee 3000", "pool": "0x6c561b446416e1a00e8e93e221854d6ea4171372", "quote_token": "WETH", "token_balance": "76072526114911", "quote_balance": "29060996929756341666149", "thin_liquidity": false, "pools_found": 7 } }, "sell_simulation": { "result": "pass", "evidence": { "pool": "0x6c561b446416e1a00e8e93e221854d6ea4171372", "amount": "76072526114", "balance_slot": "solidity:9", "method": "eth_simulateV1 transfer leg", "received": "76072526114" } }, "buy_simulation": { "result": "pass", "evidence": { "pool": "0x6c561b446416e1a00e8e93e221854d6ea4171372", "amount": "76072526114", "balance_slot": "solidity:9", "method": "eth_simulateV1 transfer leg", "received": "76072526114" } }, "transfer_tax": { "result": "pass", "evidence": { "sell_tax_pct": 0.0, "buy_tax_pct": 0.0, "note": "token-side transfer tax only; AMM/pool fees are not included" } } }, "rpc": "mainnet.base.org", "disclaimer": "Informational only, not financial advice. These are automated heuristics from public on-chain reads and simulations at a single block. They can miss risks (owner actions after this block, time-, amount- or wallet-specific traps, off-chain controls, other pools) and can flag legitimate tokens (for example regulated stablecoins with blacklist and pause functions). Do your own research." } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.005 per call. ## Doc: https://grokzilla.shop/docs/url-normalize # URL Normalizer Strip tracking params, force HTTPS, lowercase host, sort query, extract components. ## Call `POST /api/skills/url-normalize` ```json { "url": "http://Example.COM/path?utm_source=x&b=2&a=1", "options": { "stripTracking": true, "forceHttps": true, "sortQuery": true } } ``` Unpaid → HTTP 402. Price: $0.01 per call. ## Doc: https://grokzilla.shop/docs/url-to-markdown # URL to Markdown Fetch one public web page and get back its title and clean Markdown: headings, paragraphs, links (made absolute), emphasis, lists, code blocks, blockquotes, images and basic tables. Built for agents that need to read a page after a search. First-party on grokzilla.shop; no third-party API is involved. ## Call `POST /api/skills/url-to-markdown` ```json {"url": "https://example.com"} ``` `url` (required): an absolute `http://` or `https://` URL, at most 2,000 characters. ## How the page is fetched - User agent: `Mozilla/5.0 (compatible; grokzilla-url-to-markdown/1.0; +https://grokzilla.shop/terms)`. - **robots.txt is honored** for `grokzilla-url-to-markdown` (a `User-agent: grokzilla` group also matches). It is read once per host per call, including for every host a redirect leads to. Per RFC 9309, a 4xx robots.txt means no restrictions; a 5xx or unreachable one means the site is treated as disallowing crawlers. - **SSRF guard** (shared with seo and ai-detector): only http/https; every hostname is resolved and the connection pinned to a vetted public IP; private, loopback, link-local and cloud-metadata addresses are refused, on the first request and after every redirect. - At most 3 redirects, 5 seconds and 1 MB per page. Larger pages are cut at 1 MB and Markdown at 200,000 characters; `truncated` is then `true`. - Only `text/html` and `application/xhtml+xml` are converted. JavaScript is not run, so client-rendered pages may come back thin. - grokzilla.shop, grokzilla.info and x402-micro-pay.com are refused before payment (400, no 402). ## Errors (not charged) - `422 invalid_params`: missing `url`, not a string, no `http(s)://` scheme, over 2,000 characters. - `400`: `unsupported_url` (our own domains), `blocked_url` (private / metadata address), `invalid_url`, `robots_disallowed`, `robots_unreachable`, `unsupported_content_type`, `http_error` (the page returned non-2xx), `too_many_redirects`, `redirect_loop`. - `502 upstream_error`: timeout or connection failure. ## Response (paid 200) ```json { "skill": "url_to_markdown", "ok": true, "url": "https://example.com", "final_url": "https://example.com/", "title": "Example Domain", "markdown": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "bytes": 577, "truncated": false } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call. ## Doc: https://grokzilla.shop/docs/uuid-mint # UUID Minter Mint 1-32 UUID v4 (or v1) identifiers for agent job IDs and idempotency keys. First-party on grokzilla.shop. ## Call `POST /api/skills/uuid-mint` ```json { "count": 2, "version": 4 } ``` `count` (optional integer 1-32, default 1), `version` (optional `4` default, or `1`). ## Response (paid 200) IDs below are placeholders showing the shape; each paid call mints fresh random IDs. ```json { "skill": "uuid_mint", "ok": true, "version": 4, "count": 2, "ids": [ "00000000-0000-4000-8000-000000000001", "00000000-0000-4000-8000-000000000002" ] } ``` Unpaid → HTTP 402 (x402 USDC on Base). Retry with `PAYMENT-SIGNATURE`. Free preflight: send `X-X402-Validate-Only: 1` (422 on bad params, else 402). Price: $0.003 per call.