{
  "schemaVersion": "1.0",
  "item": {
    "slug": "ares-business-registry",
    "name": "ARES Business Registry (CZ)",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/PGhostek/ares-business-registry",
    "canonicalUrl": "https://clawhub.ai/PGhostek/ares-business-registry",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/ares-business-registry",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ares-business-registry",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/ares-links.md",
      "scripts/ares_client.py",
      "scripts/smoke_test.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/ares-business-registry"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/ares-business-registry",
    "agentPageUrl": "https://openagent3.xyz/skills/ares-business-registry/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ares-business-registry/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ares-business-registry/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "ARES Business Registry (CZ)",
        "body": "Use scripts/ares_client.py for ICO lookup and business search."
      },
      {
        "title": "Working directory",
        "body": "From workspace root:\n\npython3 skills/ares-business-registry/scripts/ares_client.py ...\n\n\nFrom skills/ares-business-registry:\n\npython3 scripts/ares_client.py ..."
      },
      {
        "title": "Commands",
        "body": "You can run via the wrapper (recommended):\n\n./ares ico <ico>\n./ares name \"NAME\" [--nace CODE ...] [--city CITY] [--limit N] [--offset N] [--pick INDEX]\n\nThe underlying script also supports:\n\npython3 scripts/ares_client.py search --name \"NAME\" ...\npython3 scripts/ares_client.py search --nace CODE [CODE ...] ...\npython3 scripts/ares_client.py search --name \"NAME\" --nace CODE ... (combined)"
      },
      {
        "title": "Output modes",
        "body": "default: human-readable summary\n--json: normalized JSON output (stable keys)\n--raw: full raw ARES payload"
      },
      {
        "title": "Examples",
        "body": "# ICO lookup\npython3 scripts/ares_client.py ico 27604977\npython3 scripts/ares_client.py ico 27604977 --json\npython3 scripts/ares_client.py ico 27604977 --raw\n\n# Search by name\npython3 scripts/ares_client.py search --name Google\npython3 scripts/ares_client.py search --name Google --limit 3 --json\npython3 scripts/ares_client.py search --name Google --city Praha --limit 10 --offset 0\npython3 scripts/ares_client.py search --name Google --limit 3 --pick 1\n\n# Search by NACE code (CZ-NACE, exactly 5 digits)\npython3 scripts/ares_client.py search --nace 47710 --limit 10            # all clothing retailers\npython3 scripts/ares_client.py search --nace 47710 --city Praha --json    # clothing retailers in Praha\npython3 scripts/ares_client.py search --nace 47710 47910 --limit 5        # clothing retail + mail order\n\n# Combined: name + NACE (AND filter)\npython3 scripts/ares_client.py search --name sport --nace 47710 --json    # \"sport\" in clothing retail"
      },
      {
        "title": "Normalized JSON",
        "body": "ico output:\n\n{ \"subject\": { \"name\", \"ico\", \"dic\", \"datumVzniku\", \"address\", \"codes\", \"decoded\" } }\n\n\nsearch output:\n\n{ \"query\", \"total\", \"items\", \"picked?\" }\nquery includes: name (nullable), city (nullable), nace (nullable array), limit, offset\n\n\ndic can be null.\ndatumVzniku can be null."
      },
      {
        "title": "Error JSON contract (--json only)",
        "body": "{\n  \"error\": {\n    \"code\": \"validation_error | ares_error | network_error\",\n    \"message\": \"Human readable message\",\n    \"status\": 429,\n    \"details\": {}\n  }\n}"
      },
      {
        "title": "Validation and exits",
        "body": "ICO: exactly 8 digits + mod11 checksum\nSearch: at least --name (length >= 3) or --nace required; both can be combined\n--nace: exactly 5 digits per code (CZ-NACE format, e.g. 47710); multiple codes accepted (space-separated)\n--limit: default 10, capped to 100\n--offset: must be >= 0\nExit codes:\n\n0 success\n1 validation error\n2 ARES non-OK response\n3 network/timeout"
      },
      {
        "title": "Caching and decoding",
        "body": "Legal form decoding (PravniForma) is loaded via POST /ciselniky-nazevniky/vyhledat\nCache path: skills/ares-business-registry/.cache/pravni_forma.json\nCache TTL: 24h\nIn-memory fallback is used if cache file is stale/unavailable\nCurated overrides:\n\n112 -> s.r.o.\n121 -> a.s.\n141 -> z.s.\n701 -> OSVČ\n301 -> s.p.\n331 -> p.o."
      },
      {
        "title": "NACE code search",
        "body": "--nace sends the czNace field to the ARES complex filter endpoint\nCodes must be exactly 5 digits (CZ-NACE_2025 format)\nMultiple codes can be passed (space-separated) — ARES returns entities matching any of them\nWhen combined with --name, both filters apply as AND (entities must match name AND have the NACE code)\nNACE-only search (without --name) is supported — useful for browsing all entities in a sector\nCommon e-commerce NACE codes:\n\n47710 — Retail sale of clothing\n47910 — Retail sale via mail order or internet\n47410 — Retail sale of computers and software\n47750 — Retail sale of cosmetic and toilet articles\n46420 — Wholesale of clothing and footwear\n\n\nFull CZ-NACE list: https://www.czso.cz/csu/czso/klasifikace_ekonomickych_cinnosti_cz_nace"
      },
      {
        "title": "City filter limitation",
        "body": "--city maps to sidlo.nazevObce (structured filter).\nMatching remains best-effort only; ARES server-side matching/ranking can still return records outside the expected municipality."
      },
      {
        "title": "Retries and rate limits",
        "body": "HTTP timeout: connect 5s, read 20s\nRetries for transient failures: 429/502/503/504 + network timeout/connection issues\nBackoff: 1s, 2s, 4s\nHonors Retry-After for 429 where provided"
      }
    ],
    "body": "ARES Business Registry (CZ)\n\nUse scripts/ares_client.py for ICO lookup and business search.\n\nWorking directory\nFrom workspace root:\npython3 skills/ares-business-registry/scripts/ares_client.py ...\nFrom skills/ares-business-registry:\npython3 scripts/ares_client.py ...\nCommands\n\nYou can run via the wrapper (recommended):\n\n./ares ico <ico>\n./ares name \"NAME\" [--nace CODE ...] [--city CITY] [--limit N] [--offset N] [--pick INDEX]\n\nThe underlying script also supports:\n\npython3 scripts/ares_client.py search --name \"NAME\" ...\npython3 scripts/ares_client.py search --nace CODE [CODE ...] ...\npython3 scripts/ares_client.py search --name \"NAME\" --nace CODE ... (combined)\nOutput modes\ndefault: human-readable summary\n--json: normalized JSON output (stable keys)\n--raw: full raw ARES payload\nExamples\n# ICO lookup\npython3 scripts/ares_client.py ico 27604977\npython3 scripts/ares_client.py ico 27604977 --json\npython3 scripts/ares_client.py ico 27604977 --raw\n\n# Search by name\npython3 scripts/ares_client.py search --name Google\npython3 scripts/ares_client.py search --name Google --limit 3 --json\npython3 scripts/ares_client.py search --name Google --city Praha --limit 10 --offset 0\npython3 scripts/ares_client.py search --name Google --limit 3 --pick 1\n\n# Search by NACE code (CZ-NACE, exactly 5 digits)\npython3 scripts/ares_client.py search --nace 47710 --limit 10            # all clothing retailers\npython3 scripts/ares_client.py search --nace 47710 --city Praha --json    # clothing retailers in Praha\npython3 scripts/ares_client.py search --nace 47710 47910 --limit 5        # clothing retail + mail order\n\n# Combined: name + NACE (AND filter)\npython3 scripts/ares_client.py search --name sport --nace 47710 --json    # \"sport\" in clothing retail\n\nNormalized JSON\nico output:\n{ \"subject\": { \"name\", \"ico\", \"dic\", \"datumVzniku\", \"address\", \"codes\", \"decoded\" } }\nsearch output:\n{ \"query\", \"total\", \"items\", \"picked?\" }\nquery includes: name (nullable), city (nullable), nace (nullable array), limit, offset\ndic can be null.\ndatumVzniku can be null.\nError JSON contract (--json only)\n{\n  \"error\": {\n    \"code\": \"validation_error | ares_error | network_error\",\n    \"message\": \"Human readable message\",\n    \"status\": 429,\n    \"details\": {}\n  }\n}\n\nValidation and exits\nICO: exactly 8 digits + mod11 checksum\nSearch: at least --name (length >= 3) or --nace required; both can be combined\n--nace: exactly 5 digits per code (CZ-NACE format, e.g. 47710); multiple codes accepted (space-separated)\n--limit: default 10, capped to 100\n--offset: must be >= 0\nExit codes:\n0 success\n1 validation error\n2 ARES non-OK response\n3 network/timeout\nCaching and decoding\nLegal form decoding (PravniForma) is loaded via POST /ciselniky-nazevniky/vyhledat\nCache path: skills/ares-business-registry/.cache/pravni_forma.json\nCache TTL: 24h\nIn-memory fallback is used if cache file is stale/unavailable\nCurated overrides:\n112 -> s.r.o.\n121 -> a.s.\n141 -> z.s.\n701 -> OSVČ\n301 -> s.p.\n331 -> p.o.\nNACE code search\n--nace sends the czNace field to the ARES complex filter endpoint\nCodes must be exactly 5 digits (CZ-NACE_2025 format)\nMultiple codes can be passed (space-separated) — ARES returns entities matching any of them\nWhen combined with --name, both filters apply as AND (entities must match name AND have the NACE code)\nNACE-only search (without --name) is supported — useful for browsing all entities in a sector\nCommon e-commerce NACE codes:\n47710 — Retail sale of clothing\n47910 — Retail sale via mail order or internet\n47410 — Retail sale of computers and software\n47750 — Retail sale of cosmetic and toilet articles\n46420 — Wholesale of clothing and footwear\nFull CZ-NACE list: https://www.czso.cz/csu/czso/klasifikace_ekonomickych_cinnosti_cz_nace\nCity filter limitation\n--city maps to sidlo.nazevObce (structured filter).\nMatching remains best-effort only; ARES server-side matching/ranking can still return records outside the expected municipality.\nRetries and rate limits\nHTTP timeout: connect 5s, read 20s\nRetries for transient failures: 429/502/503/504 + network timeout/connection issues\nBackoff: 1s, 2s, 4s\nHonors Retry-After for 429 where provided"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/PGhostek/ares-business-registry",
    "publisherUrl": "https://clawhub.ai/PGhostek/ares-business-registry",
    "owner": "PGhostek",
    "version": "0.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/ares-business-registry",
    "downloadUrl": "https://openagent3.xyz/downloads/ares-business-registry",
    "agentUrl": "https://openagent3.xyz/skills/ares-business-registry/agent",
    "manifestUrl": "https://openagent3.xyz/skills/ares-business-registry/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/ares-business-registry/agent.md"
  }
}