# Send ARES Business Registry (CZ) to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "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": { "downloadUrl": "/downloads/ares-business-registry", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=ares-business-registry", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/ares-links.md", "scripts/ares_client.py", "scripts/smoke_test.sh" ], "downloadMode": "redirect", "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." ] } }, "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" } } ``` ## Documentation ### ARES Business Registry (CZ) Use scripts/ares_client.py for ICO lookup and business search. ### Working directory From workspace root: python3 skills/ares-business-registry/scripts/ares_client.py ... From skills/ares-business-registry: python3 scripts/ares_client.py ... ### Commands You can run via the wrapper (recommended): ./ares ico ./ares name "NAME" [--nace CODE ...] [--city CITY] [--limit N] [--offset N] [--pick INDEX] The underlying script also supports: python3 scripts/ares_client.py search --name "NAME" ... python3 scripts/ares_client.py search --nace CODE [CODE ...] ... python3 scripts/ares_client.py search --name "NAME" --nace CODE ... (combined) ### Output modes default: human-readable summary --json: normalized JSON output (stable keys) --raw: full raw ARES payload ### Examples # ICO lookup python3 scripts/ares_client.py ico 27604977 python3 scripts/ares_client.py ico 27604977 --json python3 scripts/ares_client.py ico 27604977 --raw # Search by name python3 scripts/ares_client.py search --name Google python3 scripts/ares_client.py search --name Google --limit 3 --json python3 scripts/ares_client.py search --name Google --city Praha --limit 10 --offset 0 python3 scripts/ares_client.py search --name Google --limit 3 --pick 1 # Search by NACE code (CZ-NACE, exactly 5 digits) python3 scripts/ares_client.py search --nace 47710 --limit 10 # all clothing retailers python3 scripts/ares_client.py search --nace 47710 --city Praha --json # clothing retailers in Praha python3 scripts/ares_client.py search --nace 47710 47910 --limit 5 # clothing retail + mail order # Combined: name + NACE (AND filter) python3 scripts/ares_client.py search --name sport --nace 47710 --json # "sport" in clothing retail ### Normalized JSON ico output: { "subject": { "name", "ico", "dic", "datumVzniku", "address", "codes", "decoded" } } search output: { "query", "total", "items", "picked?" } query includes: name (nullable), city (nullable), nace (nullable array), limit, offset dic can be null. datumVzniku can be null. ### Error JSON contract (--json only) { "error": { "code": "validation_error | ares_error | network_error", "message": "Human readable message", "status": 429, "details": {} } } ### Validation and exits ICO: exactly 8 digits + mod11 checksum Search: at least --name (length >= 3) or --nace required; both can be combined --nace: exactly 5 digits per code (CZ-NACE format, e.g. 47710); multiple codes accepted (space-separated) --limit: default 10, capped to 100 --offset: must be >= 0 Exit codes: 0 success 1 validation error 2 ARES non-OK response 3 network/timeout ### Caching and decoding Legal form decoding (PravniForma) is loaded via POST /ciselniky-nazevniky/vyhledat Cache path: skills/ares-business-registry/.cache/pravni_forma.json Cache TTL: 24h In-memory fallback is used if cache file is stale/unavailable Curated overrides: 112 -> s.r.o. 121 -> a.s. 141 -> z.s. 701 -> OSVČ 301 -> s.p. 331 -> p.o. ### NACE code search --nace sends the czNace field to the ARES complex filter endpoint Codes must be exactly 5 digits (CZ-NACE_2025 format) Multiple codes can be passed (space-separated) — ARES returns entities matching any of them When combined with --name, both filters apply as AND (entities must match name AND have the NACE code) NACE-only search (without --name) is supported — useful for browsing all entities in a sector Common e-commerce NACE codes: 47710 — Retail sale of clothing 47910 — Retail sale via mail order or internet 47410 — Retail sale of computers and software 47750 — Retail sale of cosmetic and toilet articles 46420 — Wholesale of clothing and footwear Full CZ-NACE list: https://www.czso.cz/csu/czso/klasifikace_ekonomickych_cinnosti_cz_nace ### City filter limitation --city maps to sidlo.nazevObce (structured filter). Matching remains best-effort only; ARES server-side matching/ranking can still return records outside the expected municipality. ### Retries and rate limits HTTP timeout: connect 5s, read 20s Retries for transient failures: 429/502/503/504 + network timeout/connection issues Backoff: 1s, 2s, 4s Honors Retry-After for 429 where provided ## Trust - Source: tencent - Verification: Indexed source record - Publisher: PGhostek - Version: 0.2.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/ares-business-registry) - [Send to Agent page](https://openagent3.xyz/skills/ares-business-registry/agent) - [JSON manifest](https://openagent3.xyz/skills/ares-business-registry/agent.json) - [Markdown brief](https://openagent3.xyz/skills/ares-business-registry/agent.md) - [Download page](https://openagent3.xyz/downloads/ares-business-registry)