[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BJ8F7GX9AS741AVVP7QRKJ":3,"skill-same:01M7BJ8F7GX9AS741AVVP7QRKJ":59},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M7BJ8F7GX9AS741AVVP7QRKJ","censys-cenql",null,"Use when the user needs help with CenQL syntax, censys query syntax, how to write a censys query, what censys fields are available, or censys query help — field paths, operators, quoting\u002Fescaping rules, or example queries for hosts, certificates, and web properties. Trigger phrases include \"CenQL syntax,\" \"censys query syntax,\" \"how do I write a censys query,\" \"what censys fields are available,\" and \"censys query help.\" Also fires when the user writes \"CQL,\" a frequent misspelling of CenQL. This is a reference skill, not a CLI wrapper — defer to censys-search, censys-aggregate, or censys-view to actually execute the query once it's constructed.","censys\u002Fcensys-ai-skills","censys","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F14364260?v=4","01M7BJ81H5T13H27EDACWQY52A","Censys","01M7BJ81HSKBW2GD4Z7VA959XQ",14,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-cenql\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: censys-cenql\ndescription: Use when the user needs help with CenQL syntax, censys query syntax, how to write a censys query, what censys fields are available, or censys query help — field paths, operators, quoting\u002Fescaping rules, or example queries for hosts, certificates, and web properties. Trigger phrases include \"CenQL syntax,\" \"censys query syntax,\" \"how do I write a censys query,\" \"what censys fields are available,\" and \"censys query help.\" Also fires when the user writes \"CQL,\" a frequent misspelling of CenQL. This is a reference skill, not a CLI wrapper — defer to censys-search, censys-aggregate, or censys-view to actually execute the query once it's constructed.\nversion: 0.3.0\n---\n\n# Censys CenQL Reference\n\n## When to use\n\nUse this skill whenever the user needs help constructing, debugging, or understanding a Censys Query Language (CenQL) query — field paths, operators, grouping, quoting, or example patterns. This covers requests like:\n\n- \"What's the CenQL syntax for matching a port?\"\n- \"How do I write a censys query for SSH hosts not on 22?\"\n- \"What censys fields are available for TLS certificates?\"\n- \"Why is my censys query failing to parse?\"\n\nUsers sometimes write \"CQL.\" This is a misspelling of CenQL. Answer the question, and use the name CenQL in the reply.\n\nThis skill is a reference only — it does not execute queries. Once the query string is built, hand it to `censys-search` (raw search), `censys-aggregate` (counts\u002Fbreakdowns), or `censys-view` (single-record lookup) to actually run it.\n\n## Syntax fundamentals\n\n- **Field paths** are dot-separated and mirror the JSON document structure: `host.services.port`, `cert.parsed.subject.common_name`.\n- **Operators**:\n  - `=` — exact match (the field value must equal the given term exactly)\n  - `:` — contains \u002F flexible match (substring, tokenized, or \"in\" semantics depending on field type)\n  - `and`, `or` — boolean combinators\n  - `not` — negation\n- **Grouping**: use parentheses to scope compound expressions, especially when combining `and`\u002F`or` across nested fields: `host.services: (protocol=SSH and port: 22)`.\n- **CIDR notation**: IP range queries use CIDR blocks quoted as strings: `host.ip: '198.51.100.0\u002F24'`.\n- **Quoting**: wrap any value containing spaces, colons, slashes, or CenQL keywords in single quotes: `cert.parsed.issuer.organization: 'Let''s Encrypt'`.\n- **Nested field grouping**: `host.services: (...)` scopes all conditions inside the parens to the *same* service entry on the host — critical when a host has multiple services and you don't want conditions matching across unrelated services.\n\n## Host fields\n\n- **Network**: `host.ip`, `host.services.port`, `host.services.protocol`, `host.services.transport_protocol`\n- **Banners\u002Fheaders**: `host.services.banner`, `host.services.banner_hash_sha256`, `host.services.endpoints.http.headers: (key: \"\u003Cname>\" and value: \"\u003Cvalue>\")` (see Gotchas #3). Note: for HTTP body, title, and favicon content, use the Endpoint fields below — `host.services.http.response.body` does NOT work in CenQL v2.\n- **TLS\u002Fcerts**: `host.services.tls.certificates.leaf_fp_sha_256`, `host.services.tls.certificates.leaf_data.*`\n- **SSH**: `host.services.ssh.server_host_key.fingerprint_sha256`\n- **Fingerprints**: `host.services.jarm`, `host.services.tls.ja3s`\n- **Location**: `host.location.country`, `host.location.city`, `host.location.province`, `host.location.country_code`\n- **Network identity**: `host.autonomous_system.asn`, `host.autonomous_system.name`\n- **Classification**: `labels` (top-level, not `host.labels`)\n- **WHOIS**: `host.whois.organization.name`\n- **Software**: `host.services.software.vendor`, `host.services.software.product`, `host.services.software.version`\n- **OS**: `host.operating_system.product`, `host.operating_system.vendor`, `host.operating_system.version`\n- **Host metadata**: `host.service_count` (number of services — useful for profiling hosts with a specific service footprint)\n\n### Endpoint fields\n\nCertain service-level data lives under `host.services.endpoints.\u003Ctype>.*`, NOT\ndirectly under `host.services.\u003Ctype>.*`. The `endpoints.` path component is\nrequired — omitting it returns a 422 \"Field not found.\" This applies to **all**\nendpoint-extracted data: HTTP content, C2 framework configs, and any future\nendpoint type Censys adds. When in doubt about a service sub-field, try the\n`endpoints.` path first.\n\n#### HTTP\n\n| Field | Path |\n|---|---|\n| Body hash (SHA-256) | `host.services.endpoints.http.body_hash_sha256` |\n| HTML title | `host.services.endpoints.http.html_title` |\n| Body content (text search) | `host.services.endpoints.http.body` |\n| Favicon hash (SHA-256) | `host.services.endpoints.http.favicons.hash_sha256` |\n| HTML tags | `host.services.endpoints.http.html_tags` |\n| Response header | `host.services.endpoints.http.headers: (key: \"\u003Cname>\" and value: \"\u003Cvalue>\")` |\n\n#### Cobalt Strike\n\n| Field | Path |\n|---|---|\n| Watermark | `host.services.endpoints.cobalt_strike.x64.watermark` |\n| Public key | `host.services.endpoints.cobalt_strike.x64.public_key` |\n\nBoth `x64` and `x86` arch variants exist. These fields only match hosts with\n**currently active** CS listeners — hosts that had CS historically but are now\ndark (offline\u002Ffirewalled) will not appear. Verify the field is indexed by\nrunning a wildcard query (`field:*`) before interpreting 0 results as \"unique.\"\n\n## Certificate fields\n\n- **Identity**: `cert.names`, `cert.parsed.subject.common_name`, `cert.parsed.subject.organization`\n- **Issuer**: `cert.parsed.issuer.common_name`, `cert.parsed.issuer.organization`\n- **Validity**: `cert.parsed.validity_period.not_before`, `cert.parsed.validity_period.not_after`\n- **Fingerprint\u002Ftrust**: `cert.fingerprint_sha256`, `cert.validation_level`\n\n## Web property fields\n\nThe web property prefix is `web.`. The prefix `webproperty.` returns 422 \"Field not found\".\n\n- **Identity**: `web.hostname`, `web.endpoints.ip`, `web.endpoints.port`\n- **Response\u002Fclassification**: `web.endpoints.http.status_code`, `web.labels`\n- **Software**: `web.software.vendor`, `web.software.product`. Product values use the Censys name, for example `http_server` for Apache httpd, not `Apache`.\n\nFor copy-paste query examples, see [${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md).\n\n## Query construction patterns\n\nThe [cookbook](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md) gives copy-paste examples. This section teaches how to _think about_ building queries — especially when combining conditions across nested fields.\n\n### Compound service matching\n\nWithout scoping, conditions on service sub-fields match independently across _all_ services on a host:\n\n```bash\n# WRONG: matches hosts with RDP on ANY port AND port 7070 running ANY protocol\ncensys search \"host.services.protocol=RDP and host.services.port=7070\"\n\n# RIGHT: scopes both conditions to the SAME service entry\ncensys search 'host.services: (protocol=RDP and port=7070)'\n```\n\nUse separate `host.services: (...)` blocks to require _different_ services on the same host:\n\n```bash\n# Hosts with RDP on 3389 AND AnyDesk on 7070 (two distinct services)\ncensys search 'host.services: (protocol=\"RDP\" and port: 3389) and host.services: (software.product: \"AnyDesk\" and port: 7070)'\n```\n\nThis finds hosts that have both services, but doesn't constrain the _total_ number of services — see `host.service_count` below.\n\n### Service footprint profiling\n\nCombine compound matching with `host.service_count` to find hosts with a _specific_ service combination and nothing else:\n\n```bash\n# Hosts running EXACTLY RDP:3389 + AnyDesk:7070, no other services\ncensys search 'host.services: (protocol=\"RDP\" and port: 3389) and host.services: (software.product: \"AnyDesk\" and port: 7070) and host.service_count=2'\n```\n\nPurpose-built infrastructure (C2 panels, relay boxes, proxy nodes) tends to have minimal service footprints. Filtering by `service_count` surfaces these among the noise of multi-service hosts.\n\n### Operator choice: `=` vs `:`\n\n- `=` — exact match: the field value must equal the term exactly\n- `:` — flexible match: substring, tokenized, or \"in\" semantics depending on field type\n\nWhen it matters: on string fields, `:` can match substrings (`host.services.software.product: nginx` matches entries containing \"nginx\"), while `=` requires the full value. On enum-like fields (protocol, transport_protocol), both behave the same in practice.\n\nRule of thumb: use `=` when you know the exact value you're looking for; use `:` when exploring or when the value might appear as a substring of a longer string.\n\n## CenQL field → JSON output path mapping\n\nCenQL search fields do NOT always match the JSON paths in `censys view` \u002F `censys search` output. Use the CenQL column for queries, the jq column for extracting from results:\n\n| Signal | CenQL search field | jq extraction path |\n|---|---|---|\n| Cert fingerprint | `host.services.tls.certificates.leaf_fp_sha_256` | `.services[].tls.fingerprint_sha256` or `.services[].cert.fingerprint_sha256` |\n| JARM fingerprint | `host.services.jarm` | `.services[].jarm.fingerprint` |\n| Software identity | `host.services.software.product` | `.services[].software[].product` |\n| HTTP body | `host.services.endpoints.http.body` (see Gotchas #2) | `.services[].endpoints[].http.body` |\n| SSH host key | `host.services.ssh.server_host_key.fingerprint_sha256` | `.services[].ssh.server_host_key.fingerprint_sha256` (same) |\n| Banner hash | `host.services.banner_hash_sha256` | `.services[].banner_hash_sha256` (same) |\n| Labels | `labels` (top-level) | `.labels` (top-level, NOT `host.labels`) |\n| Body hash | `host.services.endpoints.http.body_hash_sha256` | `.services[].endpoints[].http.body_hash_sha256` |\n| HTML title | `host.services.endpoints.http.html_title` | `.services[].endpoints[].http.html_title` |\n| Response header | `host.services.endpoints.http.headers: (key: \"Server\" and value: \"Apache\")` | `.services[].endpoints[].http.headers.Server.headers[]` (object keyed by header name; each value is `{\"headers\": [...]}`) |\n| Body content | `host.services.endpoints.http.body` | `.services[].endpoints[].http.body` |\n| Favicon hash | `host.services.endpoints.http.favicons.hash_sha256` | `.services[].endpoints[].http.favicons[].hash_sha256` |\n| CS watermark | `host.services.endpoints.cobalt_strike.x64.watermark` | `.services[].endpoints[].cobalt_strike.x64.watermark` |\n| CS public key | `host.services.endpoints.cobalt_strike.x64.public_key` | `.services[].endpoints[].cobalt_strike.x64.public_key` |\n\n## Escaping rules\n\n- Values containing spaces, colons, slashes, hyphens, or other special characters must be wrapped in single quotes or double quotes: `'value with spaces'`, `\"remote-access\"`. Hyphens are especially treacherous — `labels: remote-access` fails because the parser reads `-access` as negation.\n- CenQL keywords (`and`, `or`, `not`) appearing *as literal values* (not as operators) must be quoted, or the parser will treat them as boolean operators.\n- Single quotes inside a quoted value are escaped by doubling them in CenQL itself (`'Let''s Encrypt'`); when that same string is passed through a shell command line, the shell's own quoting also needs escaping, which produces the doubled pattern `'\\''` seen in [cookbook](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md) example 6 — one layer for the shell, one for CenQL.\n- When in doubt, quote the value. Quoting an already-safe token (e.g., a bare number or single word) is harmless; failing to quote a token that needs it causes a parse error or a silently wrong match.\n\n## Gotchas\n\n1. **`host.` prefix required in CLI.** CenQL v2 via the CLI requires `host.` on all\n   host field paths. The Censys web UI does not — queries that work in the browser\n   will fail with a 422 on the CLI.\n\n2. **`endpoints.` level for all endpoint-extracted data.** HTTP content, Cobalt\n   Strike configs, and other endpoint-level fields live under\n   `host.services.endpoints.\u003Ctype>.*`, NOT `host.services.\u003Ctype>.*`. The extra\n   `endpoints.` nesting is required for every endpoint type. See the Endpoint\n   fields tables above.\n\n3. **HTTP header queries use a nested key\u002Fvalue block.** Put the header name in\n   `key` and the header value in `value`, under `endpoints.http.headers`:\n   `host.services: (endpoints.http.headers: (key: \"X-Powered-By\" and value: \"Express\"))`.\n   - A dotted header name does not work. `host.services.endpoints.http.headers.upgrade`\n     and `host.services.http.response.headers.server` return 422 \"Field not found\".\n   - `key=` is case-sensitive. `key=\"x-powered-by\"` matched 29,094 hosts.\n     `key=\"X-Powered-By\"` matched 1,204,043 hosts. Use `key:` to match all casings\n     (1,231,579 hosts).\n   - Put the header block inside the same `host.services: (...)` block as the other\n     service conditions. This pins the header to the same service.\n   - For software identity, `host.services.software.product` is often simpler. Censys\n     extracts software identity from headers into the software field.\n\n   (Verified with the `censys` CLI on 2026-10-29.)\n\n4. **Body text search uses `:`, not `=`.** Use\n   `host.services.endpoints.http.body:\"search string\"` (colon, flexible match) for\n   substring\u002Ftext search within body content. Use `=` only for exact match on hash\n   fields like `body_hash_sha256`.\n\n5. **`software.product` values are lowercase.** `software.product=\"AnyDesk\"` returns\n   nothing; use `software.product: \"AnyDesk\"` (`:` is case-insensitive) or\n   `software.product=\"anydesk\"` (exact lowercase).\n\nFor known-noise indicators to exclude during triage, see [${CLAUDE_SKILL_DIR}\u002Freferences\u002Fknown-noise.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fknown-noise.md).\n\n## Cross-references\n\n- **censys-search** — execute a constructed CenQL query and return matching raw records.\n- **censys-aggregate** — execute a CenQL query and return counts\u002Fbreakdowns by field instead of raw records.\n- **censys-view** — single-record lookup by IP\u002FSHA-256\u002FFQDN; does not take a CenQL query.\n- **censys-censeye** — pivot analysis with rarity bounds, useful once a CenQL query surfaces an interesting field value worth exploring further.\n- **censys-investigate** — investigation methodology and multi-step pivoting patterns that build on CenQL queries.\n","# Censys CenQL Reference\n\n## When to use\n\nUse this skill whenever the user needs help constructing, debugging, or understanding a Censys Query Language (CenQL) query — field paths, operators, grouping, quoting, or example patterns. This covers requests like:\n\n- \"What's the CenQL syntax for matching a port?\"\n- \"How do I write a censys query for SSH hosts not on 22?\"\n- \"What censys fields are available for TLS certificates?\"\n- \"Why is my censys query failing to parse?\"\n\nUsers sometimes write \"CQL.\" This is a misspelling of CenQL. Answer the question, and use the name CenQL in the reply.\n\nThis skill is a reference only — it does not execute queries. Once the query string is built, hand it to `censys-search` (raw search), `censys-aggregate` (counts\u002Fbreakdowns), or `censys-view` (single-record lookup) to actually run it.\n\n## Syntax fundamentals\n\n- **Field paths** are dot-separated and mirror the JSON document structure: `host.services.port`, `cert.parsed.subject.common_name`.\n- **Operators**:\n  - `=` — exact match (the field value must equal the given term exactly)\n  - `:` — contains \u002F flexible match (substring, tokenized, or \"in\" semantics depending on field type)\n  - `and`, `or` — boolean combinators\n  - `not` — negation\n- **Grouping**: use parentheses to scope compound expressions, especially when combining `and`\u002F`or` across nested fields: `host.services: (protocol=SSH and port: 22)`.\n- **CIDR notation**: IP range queries use CIDR blocks quoted as strings: `host.ip: '198.51.100.0\u002F24'`.\n- **Quoting**: wrap any value containing spaces, colons, slashes, or CenQL keywords in single quotes: `cert.parsed.issuer.organization: 'Let''s Encrypt'`.\n- **Nested field grouping**: `host.services: (...)` scopes all conditions inside the parens to the *same* service entry on the host — critical when a host has multiple services and you don't want conditions matching across unrelated services.\n\n## Host fields\n\n- **Network**: `host.ip`, `host.services.port`, `host.services.protocol`, `host.services.transport_protocol`\n- **Banners\u002Fheaders**: `host.services.banner`, `host.services.banner_hash_sha256`, `host.services.endpoints.http.headers: (key: \"\u003Cname>\" and value: \"\u003Cvalue>\")` (see Gotchas #3). Note: for HTTP body, title, and favicon content, use the Endpoint fields below — `host.services.http.response.body` does NOT work in CenQL v2.\n- **TLS\u002Fcerts**: `host.services.tls.certificates.leaf_fp_sha_256`, `host.services.tls.certificates.leaf_data.*`\n- **SSH**: `host.services.ssh.server_host_key.fingerprint_sha256`\n- **Fingerprints**: `host.services.jarm`, `host.services.tls.ja3s`\n- **Location**: `host.location.country`, `host.location.city`, `host.location.province`, `host.location.country_code`\n- **Network identity**: `host.autonomous_system.asn`, `host.autonomous_system.name`\n- **Classification**: `labels` (top-level, not `host.labels`)\n- **WHOIS**: `host.whois.organization.name`\n- **Software**: `host.services.software.vendor`, `host.services.software.product`, `host.services.software.version`\n- **OS**: `host.operating_system.product`, `host.operating_system.vendor`, `host.operating_system.version`\n- **Host metadata**: `host.service_count` (number of services — useful for profiling hosts with a specific service footprint)\n\n### Endpoint fields\n\nCertain service-level data lives under `host.services.endpoints.\u003Ctype>.*`, NOT\ndirectly under `host.services.\u003Ctype>.*`. The `endpoints.` path component is\nrequired — omitting it returns a 422 \"Field not found.\" This applies to **all**\nendpoint-extracted data: HTTP content, C2 framework configs, and any future\nendpoint type Censys adds. When in doubt about a service sub-field, try the\n`endpoints.` path first.\n\n#### HTTP\n\n| Field | Path |\n|---|---|\n| Body hash (SHA-256) | `host.services.endpoints.http.body_hash_sha256` |\n| HTML title | `host.services.endpoints.http.html_title` |\n| Body content (text search) | `host.services.endpoints.http.body` |\n| Favicon hash (SHA-256) | `host.services.endpoints.http.favicons.hash_sha256` |\n| HTML tags | `host.services.endpoints.http.html_tags` |\n| Response header | `host.services.endpoints.http.headers: (key: \"\u003Cname>\" and value: \"\u003Cvalue>\")` |\n\n#### Cobalt Strike\n\n| Field | Path |\n|---|---|\n| Watermark | `host.services.endpoints.cobalt_strike.x64.watermark` |\n| Public key | `host.services.endpoints.cobalt_strike.x64.public_key` |\n\nBoth `x64` and `x86` arch variants exist. These fields only match hosts with\n**currently active** CS listeners — hosts that had CS historically but are now\ndark (offline\u002Ffirewalled) will not appear. Verify the field is indexed by\nrunning a wildcard query (`field:*`) before interpreting 0 results as \"unique.\"\n\n## Certificate fields\n\n- **Identity**: `cert.names`, `cert.parsed.subject.common_name`, `cert.parsed.subject.organization`\n- **Issuer**: `cert.parsed.issuer.common_name`, `cert.parsed.issuer.organization`\n- **Validity**: `cert.parsed.validity_period.not_before`, `cert.parsed.validity_period.not_after`\n- **Fingerprint\u002Ftrust**: `cert.fingerprint_sha256`, `cert.validation_level`\n\n## Web property fields\n\nThe web property prefix is `web.`. The prefix `webproperty.` returns 422 \"Field not found\".\n\n- **Identity**: `web.hostname`, `web.endpoints.ip`, `web.endpoints.port`\n- **Response\u002Fclassification**: `web.endpoints.http.status_code`, `web.labels`\n- **Software**: `web.software.vendor`, `web.software.product`. Product values use the Censys name, for example `http_server` for Apache httpd, not `Apache`.\n\nFor copy-paste query examples, see [${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md).\n\n## Query construction patterns\n\nThe [cookbook](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md) gives copy-paste examples. This section teaches how to _think about_ building queries — especially when combining conditions across nested fields.\n\n### Compound service matching\n\nWithout scoping, conditions on service sub-fields match independently across _all_ services on a host:\n\n```bash\n# WRONG: matches hosts with RDP on ANY port AND port 7070 running ANY protocol\ncensys search \"host.services.protocol=RDP and host.services.port=7070\"\n\n# RIGHT: scopes both conditions to the SAME service entry\ncensys search 'host.services: (protocol=RDP and port=7070)'\n```\n\nUse separate `host.services: (...)` blocks to require _different_ services on the same host:\n\n```bash\n# Hosts with RDP on 3389 AND AnyDesk on 7070 (two distinct services)\ncensys search 'host.services: (protocol=\"RDP\" and port: 3389) and host.services: (software.product: \"AnyDesk\" and port: 7070)'\n```\n\nThis finds hosts that have both services, but doesn't constrain the _total_ number of services — see `host.service_count` below.\n\n### Service footprint profiling\n\nCombine compound matching with `host.service_count` to find hosts with a _specific_ service combination and nothing else:\n\n```bash\n# Hosts running EXACTLY RDP:3389 + AnyDesk:7070, no other services\ncensys search 'host.services: (protocol=\"RDP\" and port: 3389) and host.services: (software.product: \"AnyDesk\" and port: 7070) and host.service_count=2'\n```\n\nPurpose-built infrastructure (C2 panels, relay boxes, proxy nodes) tends to have minimal service footprints. Filtering by `service_count` surfaces these among the noise of multi-service hosts.\n\n### Operator choice: `=` vs `:`\n\n- `=` — exact match: the field value must equal the term exactly\n- `:` — flexible match: substring, tokenized, or \"in\" semantics depending on field type\n\nWhen it matters: on string fields, `:` can match substrings (`host.services.software.product: nginx` matches entries containing \"nginx\"), while `=` requires the full value. On enum-like fields (protocol, transport_protocol), both behave the same in practice.\n\nRule of thumb: use `=` when you know the exact value you're looking for; use `:` when exploring or when the value might appear as a substring of a longer string.\n\n## CenQL field → JSON output path mapping\n\nCenQL search fields do NOT always match the JSON paths in `censys view` \u002F `censys search` output. Use the CenQL column for queries, the jq column for extracting from results:\n\n| Signal | CenQL search field | jq extraction path |\n|---|---|---|\n| Cert fingerprint | `host.services.tls.certificates.leaf_fp_sha_256` | `.services[].tls.fingerprint_sha256` or `.services[].cert.fingerprint_sha256` |\n| JARM fingerprint | `host.services.jarm` | `.services[].jarm.fingerprint` |\n| Software identity | `host.services.software.product` | `.services[].software[].product` |\n| HTTP body | `host.services.endpoints.http.body` (see Gotchas #2) | `.services[].endpoints[].http.body` |\n| SSH host key | `host.services.ssh.server_host_key.fingerprint_sha256` | `.services[].ssh.server_host_key.fingerprint_sha256` (same) |\n| Banner hash | `host.services.banner_hash_sha256` | `.services[].banner_hash_sha256` (same) |\n| Labels | `labels` (top-level) | `.labels` (top-level, NOT `host.labels`) |\n| Body hash | `host.services.endpoints.http.body_hash_sha256` | `.services[].endpoints[].http.body_hash_sha256` |\n| HTML title | `host.services.endpoints.http.html_title` | `.services[].endpoints[].http.html_title` |\n| Response header | `host.services.endpoints.http.headers: (key: \"Server\" and value: \"Apache\")` | `.services[].endpoints[].http.headers.Server.headers[]` (object keyed by header name; each value is `{\"headers\": [...]}`) |\n| Body content | `host.services.endpoints.http.body` | `.services[].endpoints[].http.body` |\n| Favicon hash | `host.services.endpoints.http.favicons.hash_sha256` | `.services[].endpoints[].http.favicons[].hash_sha256` |\n| CS watermark | `host.services.endpoints.cobalt_strike.x64.watermark` | `.services[].endpoints[].cobalt_strike.x64.watermark` |\n| CS public key | `host.services.endpoints.cobalt_strike.x64.public_key` | `.services[].endpoints[].cobalt_strike.x64.public_key` |\n\n## Escaping rules\n\n- Values containing spaces, colons, slashes, hyphens, or other special characters must be wrapped in single quotes or double quotes: `'value with spaces'`, `\"remote-access\"`. Hyphens are especially treacherous — `labels: remote-access` fails because the parser reads `-access` as negation.\n- CenQL keywords (`and`, `or`, `not`) appearing *as literal values* (not as operators) must be quoted, or the parser will treat them as boolean operators.\n- Single quotes inside a quoted value are escaped by doubling them in CenQL itself (`'Let''s Encrypt'`); when that same string is passed through a shell command line, the shell's own quoting also needs escaping, which produces the doubled pattern `'\\''` seen in [cookbook](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcookbook.md) example 6 — one layer for the shell, one for CenQL.\n- When in doubt, quote the value. Quoting an already-safe token (e.g., a bare number or single word) is harmless; failing to quote a token that needs it causes a parse error or a silently wrong match.\n\n## Gotchas\n\n1. **`host.` prefix required in CLI.** CenQL v2 via the CLI requires `host.` on all\n   host field paths. The Censys web UI does not — queries that work in the browser\n   will fail with a 422 on the CLI.\n\n2. **`endpoints.` level for all endpoint-extracted data.** HTTP content, Cobalt\n   Strike configs, and other endpoint-level fields live under\n   `host.services.endpoints.\u003Ctype>.*`, NOT `host.services.\u003Ctype>.*`. The extra\n   `endpoints.` nesting is required for every endpoint type. See the Endpoint\n   fields tables above.\n\n3. **HTTP header queries use a nested key\u002Fvalue block.** Put the header name in\n   `key` and the header value in `value`, under `endpoints.http.headers`:\n   `host.services: (endpoints.http.headers: (key: \"X-Powered-By\" and value: \"Express\"))`.\n   - A dotted header name does not work. `host.services.endpoints.http.headers.upgrade`\n     and `host.services.http.response.headers.server` return 422 \"Field not found\".\n   - `key=` is case-sensitive. `key=\"x-powered-by\"` matched 29,094 hosts.\n     `key=\"X-Powered-By\"` matched 1,204,043 hosts. Use `key:` to match all casings\n     (1,231,579 hosts).\n   - Put the header block inside the same `host.services: (...)` block as the other\n     service conditions. This pins the header to the same service.\n   - For software identity, `host.services.software.product` is often simpler. Censys\n     extracts software identity from headers into the software field.\n\n   (Verified with the `censys` CLI on 2026-10-29.)\n\n4. **Body text search uses `:`, not `=`.** Use\n   `host.services.endpoints.http.body:\"search string\"` (colon, flexible match) for\n   substring\u002Ftext search within body content. Use `=` only for exact match on hash\n   fields like `body_hash_sha256`.\n\n5. **`software.product` values are lowercase.** `software.product=\"AnyDesk\"` returns\n   nothing; use `software.product: \"AnyDesk\"` (`:` is case-insensitive) or\n   `software.product=\"anydesk\"` (exact lowercase).\n\nFor known-noise indicators to exclude during triage, see [${CLAUDE_SKILL_DIR}\u002Freferences\u002Fknown-noise.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fknown-noise.md).\n\n## Cross-references\n\n- **censys-search** — execute a constructed CenQL query and return matching raw records.\n- **censys-aggregate** — execute a CenQL query and return counts\u002Fbreakdowns by field instead of raw records.\n- **censys-view** — single-record lookup by IP\u002FSHA-256\u002FFQDN; does not take a CenQL query.\n- **censys-censeye** — pivot analysis with rarity bounds, useful once a CenQL query surfaces an interesting field value worth exploring further.\n- **censys-investigate** — investigation methodology and multi-step pivoting patterns that build on CenQL queries.\n",{"name":5,"version":24,"description":7},"0.3.0","main","cc048d5e7a4bcba276bd9b76ef9521a4a9a301bb","skills\u002Fcensys-cenql",0,"https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills","https:\u002F\u002Fcensys.com","https:\u002F\u002Fgithub.com\u002Fcensys","https:\u002F\u002Fwww.censys.com","Censys is a platform that helps information security practitioners discover, monitor, and analyze devices that are accessible from the Internet. ","2026-10-30 20:49:31",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add censys\u002Fcensys-ai-skills --skill censys-cenql",{"tool":41,"command":42},"bunx","bunx skills add censys\u002Fcensys-ai-skills --skill censys-cenql",{"tool":44,"command":45},"pnpm","pnpm dlx skills add censys\u002Fcensys-ai-skills --skill censys-cenql","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-cenql\u002FSKILL.md",true,[49,55],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcookbook.md","REFERENCE","参考文档",2463,"https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-cenql\u002Freferences\u002Fcookbook.md",{"path":56,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fknown-noise.md",1459,"https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-cenql\u002Freferences\u002Fknown-noise.md",[60,67,74,81,88,95],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7BJ9NW35DSAQF8YTHQPBAKR","censys-view","Use when the user wants detailed point-lookup data on a single asset via the Censys CLI — e.g. \"censys view,\" \"censys look up this IP,\" \"censys host details for,\" \"view this cert on censys,\" \"censys what services does X run,\" \"censys view this cert,\" \"look this host up on censys,\" \"censys pull the record for,\" \"what does censys show for this hostname,\" \"what's running on this IP,\" \"profile this host,\" or \"show me this host's services.\" Wraps `censys view` for hosts, certificates, and web properties. This is the right skill for any single-asset lookup — use censys-investigate only when the user explicitly asks for a multi-step investigation. Not for search-by-criteria (see censys-search) or time-series history (see censys-timeline).","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-view\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7BJ9FQKTDKNF0QF310AXCCK","censys-timeline","Use when the user wants temporal analysis of how a Censys-tracked asset changed over time — e.g. \"censys timeline,\" \"censys host history,\" \"censys what changed on this host,\" \"censys when did this service appear,\" \"censys change detection,\" \"censys temporal analysis,\" \"censys track cert rotations,\" or \"censys did this host change hands.\" Wraps `censys history` for hosts, web properties, and certificates. Not for current-state lookups (see censys-view) or criteria search (see censys-search).","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-timeline\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7BJ99X2HQDJQZPX0H1T4D5F","censys-search","Use when the user wants to run a censys search, censys search for hosts or certificates, search censys for hosts\u002Fcerts\u002Fweb properties, find censys hosts with a given condition, run a censys query for hosts, or search for certificates on censys using CenQL. Wraps the `censys search` CLI subcommand. Trigger phrases include \"censys search,\" \"search censys for,\" \"find censys hosts with,\" \"censys query for hosts,\" and \"search for certificates on censys.\" Do not use for viewing a single known host\u002Fcert\u002Fdomain by identifier (see censys-view) or for aggregating\u002Fcounting by field (see censys-aggregate).","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-search\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7BJ92MPX233B39VEGNYMQ10","censys-investigate","Use when the user explicitly requests a multi-step Censys investigation — e.g. \"censys investigate,\" \"censys deep dive into,\" \"trace this infrastructure with censys,\" \"censys pivot chain,\" \"full censys investigation,\" \"hunt for related infrastructure,\" or \"\u002Fcensys-investigate.\" This is a heavyweight methodology skill (typically 20–50+ API calls) — do NOT fire on simple lookups like \"what's running on this IP\" or \"profile this host\" (use censys-view for those). Structured as a baseline collection phase followed by decision trees that branch on what the baseline reveals. Prescribes a findings template and data preservation convention. Always confirms scope and estimated cost with the user before starting.","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-investigate\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7BJ8VZQEG7NH69FEJG35QBN","censys-enrich","Use when the user wants fast, credit-free IP context for SOC\u002Ftriage work via the Censys CLI — e.g. \"censys enrich,\" \"censys enrich this IP,\" \"censys bulk enrich,\" \"censys triage IP,\" \"censys SOC lookup,\" \"is this IP interesting per censys,\" \"censys check this IP for scanning activity,\" or \"censys reputation on this address.\" Wraps `censys enrich` for single\u002Fbulk IP enrichment (location, AS, WHOIS, DNS, labels, GreyNoise, reputation, network\u002Fprivacy classification, third-party verdicts). Not for full host records with all services and raw banners (see censys-view) or criteria-based search (see censys-search).","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-enrich\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7BJ8P27Y1W0S9APMBY5TDMX","censys-censeye","Use when the user wants to run censys censeye, censys pivot analysis, censys rarity analysis, censys find related infrastructure, or run censeye on a host. Wraps the `censys censeye` CLI subcommand to analyze a single host and generate pivotable threat-hunting queries bounded by rarity (how many other hosts share each attribute). Trigger phrases include \"censys censeye,\" \"censys pivot analysis,\" \"censys rarity analysis,\" \"censys find related infrastructure,\" and \"run censeye on.\" Requires Threat Hunting feature access on the organization. Not for criteria-based search (see censys-search) or single-record point lookups (see censys-view).","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-censeye\u002FSKILL.md",[],[]]