[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7BJ9FQKTDKNF0QF310AXCCK":3,"skill-same:01M7BJ9FQKTDKNF0QF310AXCCK":55},{"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},"01M7BJ9FQKTDKNF0QF310AXCCK","censys-timeline",null,"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).","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-timeline\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: censys-timeline\ndescription: 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).\nversion: 0.1.0\n---\n\n# censys-timeline\n\n## When to use\n\nUse this skill when the user wants to understand how an asset changed across a\nwindow of time, rather than its current state. Typical asks:\n\n- \"censys timeline for 8.8.8.8\"\n- \"censys host history — what changed on this box last month\"\n- \"censys when did port 8443 first appear on this IP\"\n- \"censys change detection over the last 90 days\"\n- \"censys temporal analysis of this web property\"\n- \"did this host change hands, per censys\"\n\nDo **not** use this for a single point-in-time lookup (`censys-view`), for\ncriteria-based search (`censys-search`), or for post-retrieval jq\u002FSQLite recipes\non data you already have (`censys-analyze`, which this skill hands off to once\ntimeline JSON is pulled). This skill covers pulling and interpreting `censys\nhistory` output specifically.\n\n## Invocation\n\n```bash\ncensys history \u003Casset> [flags]\n```\n\n`\u003Casset>` type is auto-detected, same rules as `censys view`:\n\n| Input pattern | Resolved as |\n|---|---|\n| IP address (e.g. `8.8.8.8`) | Host |\n| `hostname:port` | Web property |\n| 64-character hex string | Certificate (SHA-256 fingerprint) — requires Threat Hunting module access |\n\n### Skill-specific flags\n\n| Flag | Purpose |\n|---|---|\n| `--duration`, `-d \u003Cwindow>` | Time window ending now, e.g. `24h`, `7d` (default), `4w`, `1y` |\n| `--start`, `-s \u003CRFC3339>` | Absolute window start |\n| `--end`, `-e \u003CRFC3339>` | Absolute window end |\n\n`--start`\u002F`--end` and `--duration` compose (per CLI help examples):\n\n| Flags given | Window |\n|---|---|\n| `--duration` only | now − duration → now |\n| `--start` + `--duration` | start → start + duration |\n| `--end` + `--duration` | end − duration → end |\n| `--start` + `--end` | exact window; `--duration` ignored if also passed |\n\n### Global CLI flags\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcli-globals.md` for the full global flags reference (output\nformat, streaming, diagnostics, org-id, and PAT vs OAuth notes). Note:\n`history` does not support `-O short` or `-O template` (exit code 2).\n\n## Event model\n\nA host timeline is a sequence of discrete events, each with an `event_time` and\na typed payload key. Treat the timeline as a diff stream, not a series of full\nsnapshots — each event describes what changed, not the whole host state at that\nmoment.\n\n### Event types and their JSON structure\n\nEach event has `event_time` plus exactly one of these payload keys (verified against cencli 1.1.3 output, 2026-08):\n\n| Payload key | What it captures | Protocol field |\n|---|---|---|\n| `endpoint_scanned` | HTTP\u002Fbanner-level observation (headers, body, HTML title) | `.endpoint_scanned.scan.endpoint_type` |\n| `service_scanned` | Service-level observation (TLS, SSH, RDP, protocol ID) | `.service_scanned.scan.protocol` |\n| `jarm_scanned` | JARM fingerprint observation | `.jarm_scanned.scan.fingerprint` |\n| `forward_dns_resolved` | DNS A\u002FAAAA resolution change | — |\n| `reverse_dns_resolved` | Reverse DNS (PTR) change | — |\n| `whois_updated` | WHOIS registration change | — |\n\nNote that `endpoint_scanned` and `service_scanned` use **different field names** for the protocol (`endpoint_type` vs `protocol`). A single port can produce both event types, and can show multiple protocols (e.g. port 8888 responding as both `HTTP` and `DVR_IP` depending on the probe).\n\n### Semantic categories\n\nUse event types to classify changes:\n\n- **Service events** (`service_scanned`) — a port opened, closed, or its\n  transport\u002Fapplication protocol changed.\n- **Endpoint events** (`endpoint_scanned`) — the `Server` header, raw banner,\n  HTML title, or other application-layer text changed.\n- **Certificate events** (`service_scanned` with `.tls`) — the TLS certificate\n  rotated. Note: cert fingerprint lives at `.service_scanned.scan.tls.fingerprint_sha256` (an extra `.scan` level compared to `censys view` output).\n- **Infrastructure events** (`whois_updated`, DNS events) — the announcing AS\n  changed, WHOIS registration updated, or DNS resolution shifted.\n\n## Common patterns\n\n```bash\n# Last 30 days — always save to file for reuse across jq passes\ncensys history 8.8.8.8 --duration 30d -O json > data\u002Ftimeline.json\n\n# Bounded window for incident investigation\ncensys history 8.8.8.8 --start \u003Cstart-date> --end \u003Cend-date> -O json\n\n# Web property history\ncensys history example.com:443 --duration 14d -O json\n\n# Certificate observation history (Threat Hunting module required)\ncensys history \u003Csha256> --start \u003Cstart-date> --end \u003Cend-date>\n\n# Stream events as NDJSON instead of buffering a full array\ncensys history 8.8.8.8 --duration 90d -S\n```\n\n## Temporal analysis with jq\n\n```bash\n# When did a specific port first appear?\njq '[.[] | select(.service_scanned.scan.port == 8443) | .event_time] | sort | .[0]' \\\n  data\u002Ftimeline.json\n\n# Track cert rotations over time (unique leaf fingerprints in order)\njq '[.[] | .service_scanned.scan.tls.fingerprint_sha256 \u002F\u002F empty |\n    {cert: .}] | unique_by(.cert)' data\u002Ftimeline.json\n\n# Find all service-level changes, chronologically\njq '[.[] | select(.service_scanned) | {time: .event_time,\n    port: .service_scanned.scan.port,\n    protocol: .service_scanned.scan.protocol}] | sort_by(.time)' \\\n  data\u002Ftimeline.json\n\n# Compare host state at two points in time (snapshot diff, not history events)\ncensys view 203.0.113.50 --at-time \u003Cpast-date> -O json > data\u002Fbefore.json\ncensys view 203.0.113.50 -O json > data\u002Fafter.json\ndiff \u003C(jq -S '.[0].services | sort_by(.port)' data\u002Fbefore.json) \\\n     \u003C(jq -S '.[0].services | sort_by(.port)' data\u002Fafter.json)\n```\n\nFor anything beyond these direct lookups — cross-referencing multiple hosts'\ntimelines, loading into SQLite for aggregation, batch cert analysis — hand off\nto `censys-analyze` once the timeline JSON is on disk.\n\n## Change detection workflow\n\n1. Pull history with a wide window: `censys history \u003Cip> --duration 90d -O json > data\u002Ftimeline.json`.\n2. Extract event timestamps and types with jq (see patterns above) to build a\n   chronological list of what changed and when.\n3. Look for **clusters** — multiple distinct event types (e.g. new cert + new\n   SSH key + new open ports) landing within the same short window. A cluster\n   across independent signals is a much stronger change signal than any single\n   event in isolation.\n4. For each cluster, snapshot before and after with `censys view --at-time`\n   bracketing the cluster's start and end.\n5. Diff the before\u002Fafter snapshots (see the `diff` pattern above) to pin down\n   exactly what changed, rather than inferring it from event summaries alone.\n\n## Interpreting timeline data\n\n- **Routine, low signal** — certificate renewals on a roughly 90-day cycle (Let's\n  Encrypt and similar ACME issuers), minor banner version bumps, transient\n  port flaps. Expected background noise on any long-lived host.\n- **Significant, worth flagging** — SSH host key rotation, several services\n  appearing or disappearing at the same time, an AS number change, or a\n  wholesale change of certificate issuer (e.g. a self-signed cert replacing a\n  publicly-trusted one, or vice versa).\n- **Attribution boundaries** — when a cluster of simultaneous changes lines up\n  (new SSH host key + new certificates + new service set appearing together),\n  treat that cluster as a probable operator\u002Ftenant boundary. Activity observed\n  before the cluster and activity observed after it may belong to different\n  actors entirely — don't attribute both sides of the boundary to the same\n  operator without corroborating evidence.\n- **Service lifecycle** — a service that has been present across the entire\n  queried window is \"normal\" for that host. A service that first appears\n  partway through the window (especially one atypical for the host's apparent\n  role) is a candidate for new deployment or compromise, and warrants closer\n  inspection of what else changed around the same `event_time`.\n\n## Performance characteristics\n\nHistory volume depends heavily on the host and time window. A busy,\nwell-scanned host can produce thousands of events per day — measured:\n8.8.8.8 returned 2,621 events for a single day (measured on cencli 1.1.3, 2026-08).\n\n**Always use streaming (`-S`) for history pulls.** Buffered output (`-O json`\nwithout `-S`) loads the entire result into memory before writing anything.\nOn a large history this can take minutes or never complete. Streaming emits\nevents as they arrive and completes in a fraction of the time.\n\nFor bulk history pulls across many hosts:\n\n- **Start narrow.** Use `--duration 7d` or `--duration 30d` to confirm\n  the signal is there before widening. A 1-year pull on an active host\n  can produce hundreds of thousands of events.\n- **Chunk into batches of 3–5** with extended timeouts (300s+) if doing\n  sequential pulls. Save each result to `data\u002F` as it completes.\n- **Budget time generously.** Even with streaming, a 90-day pull on an\n  active host can take 60–180 seconds.\n\n## Parsing CLI output programmatically\n\nWhen redirecting `censys history -O json` to a file and parsing it later:\n\n1. **stdout is valid JSON.** The output (when using `-O json`) is a single\n   JSON array starting on the first line. Parse it directly — no line-skipping\n   needed. The status line goes to stderr and `-q` suppresses it.\n2. **Empty results may be `null`.** Some hosts return `null` instead of `[]`\n   for zero events. Defensive parsing: `data = json.load(f) or []`.\n3. **Large outputs.** A 3000-event history can be several MB of JSON. For\n   repeated analysis passes, save to disk and use `jq` or load into\n   a Python dict once rather than re-pulling.\n\n## Error handling\n\n| Error | Cause | Resolution |\n|---|---|---|\n| Exit code 2, unsupported format | `-O short` or `-O template` passed to `history` | Use `json`, `yaml`, or `tree` instead |\n| `[Threat Hunting Required]` (or similar entitlement error) | Certificate history requested without Threat Hunting module access | Confirm module entitlement, or fall back to host\u002Fweb-property history if the cert itself isn't the actual target |\n| Slow response \u002F rate limited | Window too wide (e.g. `1y`) or too many concurrent history pulls | Start with `--duration 7d`, confirm the signal is there, then widen incrementally rather than jumping straight to a multi-year pull. See Performance characteristics above for expected times. |\n| Empty result set | No events in the requested window | Widen the window, or confirm the asset had any Censys-observed activity at all via `censys view` first |\n\n## Caveats\n\n- History events are diffs against the prior observed state, not full\n  snapshots — don't assume every field is repeated on every event. Use\n  `censys view --at-time` when a complete point-in-time record is needed.\n- Wide time windows are slow and count more heavily against rate limits. Widen\n  incrementally (`7d` → `30d` → `90d`) rather than defaulting to a large window.\n- GeoIP\u002Flocation events reflect registry and geolocation data, which can lag or\n  be imprecise — corroborate an apparent \"location change\" with the\n  accompanying AS change before treating it as a strong reassignment signal.\n- Labels and event classifications are Censys-derived heuristics; treat them as\n  triage aids, not ground truth, especially for attribution calls.\n- **A port can be absent from the whole event stream and still be open.** The\n  history stream does not always cover every port on a host. A port can produce\n  zero events across a full year — no success events and no failure events — while\n  `censys view` shows the same port scanned on the same day, with a complete\n  banner. Absence of events is not evidence that the service was down or\n  intermittent.\n\n  Confirm coverage before you make any claim about when a service started, stopped,\n  or flapped:\n\n  ```bash\n  # ports present in the history stream\n  jq -r '[.[].service_scanned.scan.port] | unique' history.json\n  # ports open right now\n  jq -r '[.[0].services[].port] | sort' view.json\n  ```\n\n  If a port is in the second list but not the first, the history stream does not\n  cover that port. State this as an instrumentation gap. Two consequences follow:\n\n  1. First-seen dates from history are a **lower bound**, and they are anchored\n     only to the ports the stream does cover.\n  2. Do not report the gap as intermittent service. A real case: ports 8085–8087\n     produced zero events across one year on five of six C2 hosts, while the\n     current snapshot showed all three ports scanned that morning. Reading the gap\n     as intermittent C2 would have been a false finding.\n\n## Cross-references\n\n- For a single point-in-time snapshot (including `--at-time` on a specific\n  date), see `censys-view`.\n- For post-retrieval analysis of saved timeline JSON — jq recipes, SQLite\n  loading, batch cert correlation, cross-referencing multiple assets — see\n  `censys-analyze`.\n- For the broader investigation workflow this fits into, see\n  `censys-investigate`.\n","# censys-timeline\n\n## When to use\n\nUse this skill when the user wants to understand how an asset changed across a\nwindow of time, rather than its current state. Typical asks:\n\n- \"censys timeline for 8.8.8.8\"\n- \"censys host history — what changed on this box last month\"\n- \"censys when did port 8443 first appear on this IP\"\n- \"censys change detection over the last 90 days\"\n- \"censys temporal analysis of this web property\"\n- \"did this host change hands, per censys\"\n\nDo **not** use this for a single point-in-time lookup (`censys-view`), for\ncriteria-based search (`censys-search`), or for post-retrieval jq\u002FSQLite recipes\non data you already have (`censys-analyze`, which this skill hands off to once\ntimeline JSON is pulled). This skill covers pulling and interpreting `censys\nhistory` output specifically.\n\n## Invocation\n\n```bash\ncensys history \u003Casset> [flags]\n```\n\n`\u003Casset>` type is auto-detected, same rules as `censys view`:\n\n| Input pattern | Resolved as |\n|---|---|\n| IP address (e.g. `8.8.8.8`) | Host |\n| `hostname:port` | Web property |\n| 64-character hex string | Certificate (SHA-256 fingerprint) — requires Threat Hunting module access |\n\n### Skill-specific flags\n\n| Flag | Purpose |\n|---|---|\n| `--duration`, `-d \u003Cwindow>` | Time window ending now, e.g. `24h`, `7d` (default), `4w`, `1y` |\n| `--start`, `-s \u003CRFC3339>` | Absolute window start |\n| `--end`, `-e \u003CRFC3339>` | Absolute window end |\n\n`--start`\u002F`--end` and `--duration` compose (per CLI help examples):\n\n| Flags given | Window |\n|---|---|\n| `--duration` only | now − duration → now |\n| `--start` + `--duration` | start → start + duration |\n| `--end` + `--duration` | end − duration → end |\n| `--start` + `--end` | exact window; `--duration` ignored if also passed |\n\n### Global CLI flags\n\nSee `${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcli-globals.md` for the full global flags reference (output\nformat, streaming, diagnostics, org-id, and PAT vs OAuth notes). Note:\n`history` does not support `-O short` or `-O template` (exit code 2).\n\n## Event model\n\nA host timeline is a sequence of discrete events, each with an `event_time` and\na typed payload key. Treat the timeline as a diff stream, not a series of full\nsnapshots — each event describes what changed, not the whole host state at that\nmoment.\n\n### Event types and their JSON structure\n\nEach event has `event_time` plus exactly one of these payload keys (verified against cencli 1.1.3 output, 2026-08):\n\n| Payload key | What it captures | Protocol field |\n|---|---|---|\n| `endpoint_scanned` | HTTP\u002Fbanner-level observation (headers, body, HTML title) | `.endpoint_scanned.scan.endpoint_type` |\n| `service_scanned` | Service-level observation (TLS, SSH, RDP, protocol ID) | `.service_scanned.scan.protocol` |\n| `jarm_scanned` | JARM fingerprint observation | `.jarm_scanned.scan.fingerprint` |\n| `forward_dns_resolved` | DNS A\u002FAAAA resolution change | — |\n| `reverse_dns_resolved` | Reverse DNS (PTR) change | — |\n| `whois_updated` | WHOIS registration change | — |\n\nNote that `endpoint_scanned` and `service_scanned` use **different field names** for the protocol (`endpoint_type` vs `protocol`). A single port can produce both event types, and can show multiple protocols (e.g. port 8888 responding as both `HTTP` and `DVR_IP` depending on the probe).\n\n### Semantic categories\n\nUse event types to classify changes:\n\n- **Service events** (`service_scanned`) — a port opened, closed, or its\n  transport\u002Fapplication protocol changed.\n- **Endpoint events** (`endpoint_scanned`) — the `Server` header, raw banner,\n  HTML title, or other application-layer text changed.\n- **Certificate events** (`service_scanned` with `.tls`) — the TLS certificate\n  rotated. Note: cert fingerprint lives at `.service_scanned.scan.tls.fingerprint_sha256` (an extra `.scan` level compared to `censys view` output).\n- **Infrastructure events** (`whois_updated`, DNS events) — the announcing AS\n  changed, WHOIS registration updated, or DNS resolution shifted.\n\n## Common patterns\n\n```bash\n# Last 30 days — always save to file for reuse across jq passes\ncensys history 8.8.8.8 --duration 30d -O json > data\u002Ftimeline.json\n\n# Bounded window for incident investigation\ncensys history 8.8.8.8 --start \u003Cstart-date> --end \u003Cend-date> -O json\n\n# Web property history\ncensys history example.com:443 --duration 14d -O json\n\n# Certificate observation history (Threat Hunting module required)\ncensys history \u003Csha256> --start \u003Cstart-date> --end \u003Cend-date>\n\n# Stream events as NDJSON instead of buffering a full array\ncensys history 8.8.8.8 --duration 90d -S\n```\n\n## Temporal analysis with jq\n\n```bash\n# When did a specific port first appear?\njq '[.[] | select(.service_scanned.scan.port == 8443) | .event_time] | sort | .[0]' \\\n  data\u002Ftimeline.json\n\n# Track cert rotations over time (unique leaf fingerprints in order)\njq '[.[] | .service_scanned.scan.tls.fingerprint_sha256 \u002F\u002F empty |\n    {cert: .}] | unique_by(.cert)' data\u002Ftimeline.json\n\n# Find all service-level changes, chronologically\njq '[.[] | select(.service_scanned) | {time: .event_time,\n    port: .service_scanned.scan.port,\n    protocol: .service_scanned.scan.protocol}] | sort_by(.time)' \\\n  data\u002Ftimeline.json\n\n# Compare host state at two points in time (snapshot diff, not history events)\ncensys view 203.0.113.50 --at-time \u003Cpast-date> -O json > data\u002Fbefore.json\ncensys view 203.0.113.50 -O json > data\u002Fafter.json\ndiff \u003C(jq -S '.[0].services | sort_by(.port)' data\u002Fbefore.json) \\\n     \u003C(jq -S '.[0].services | sort_by(.port)' data\u002Fafter.json)\n```\n\nFor anything beyond these direct lookups — cross-referencing multiple hosts'\ntimelines, loading into SQLite for aggregation, batch cert analysis — hand off\nto `censys-analyze` once the timeline JSON is on disk.\n\n## Change detection workflow\n\n1. Pull history with a wide window: `censys history \u003Cip> --duration 90d -O json > data\u002Ftimeline.json`.\n2. Extract event timestamps and types with jq (see patterns above) to build a\n   chronological list of what changed and when.\n3. Look for **clusters** — multiple distinct event types (e.g. new cert + new\n   SSH key + new open ports) landing within the same short window. A cluster\n   across independent signals is a much stronger change signal than any single\n   event in isolation.\n4. For each cluster, snapshot before and after with `censys view --at-time`\n   bracketing the cluster's start and end.\n5. Diff the before\u002Fafter snapshots (see the `diff` pattern above) to pin down\n   exactly what changed, rather than inferring it from event summaries alone.\n\n## Interpreting timeline data\n\n- **Routine, low signal** — certificate renewals on a roughly 90-day cycle (Let's\n  Encrypt and similar ACME issuers), minor banner version bumps, transient\n  port flaps. Expected background noise on any long-lived host.\n- **Significant, worth flagging** — SSH host key rotation, several services\n  appearing or disappearing at the same time, an AS number change, or a\n  wholesale change of certificate issuer (e.g. a self-signed cert replacing a\n  publicly-trusted one, or vice versa).\n- **Attribution boundaries** — when a cluster of simultaneous changes lines up\n  (new SSH host key + new certificates + new service set appearing together),\n  treat that cluster as a probable operator\u002Ftenant boundary. Activity observed\n  before the cluster and activity observed after it may belong to different\n  actors entirely — don't attribute both sides of the boundary to the same\n  operator without corroborating evidence.\n- **Service lifecycle** — a service that has been present across the entire\n  queried window is \"normal\" for that host. A service that first appears\n  partway through the window (especially one atypical for the host's apparent\n  role) is a candidate for new deployment or compromise, and warrants closer\n  inspection of what else changed around the same `event_time`.\n\n## Performance characteristics\n\nHistory volume depends heavily on the host and time window. A busy,\nwell-scanned host can produce thousands of events per day — measured:\n8.8.8.8 returned 2,621 events for a single day (measured on cencli 1.1.3, 2026-08).\n\n**Always use streaming (`-S`) for history pulls.** Buffered output (`-O json`\nwithout `-S`) loads the entire result into memory before writing anything.\nOn a large history this can take minutes or never complete. Streaming emits\nevents as they arrive and completes in a fraction of the time.\n\nFor bulk history pulls across many hosts:\n\n- **Start narrow.** Use `--duration 7d` or `--duration 30d` to confirm\n  the signal is there before widening. A 1-year pull on an active host\n  can produce hundreds of thousands of events.\n- **Chunk into batches of 3–5** with extended timeouts (300s+) if doing\n  sequential pulls. Save each result to `data\u002F` as it completes.\n- **Budget time generously.** Even with streaming, a 90-day pull on an\n  active host can take 60–180 seconds.\n\n## Parsing CLI output programmatically\n\nWhen redirecting `censys history -O json` to a file and parsing it later:\n\n1. **stdout is valid JSON.** The output (when using `-O json`) is a single\n   JSON array starting on the first line. Parse it directly — no line-skipping\n   needed. The status line goes to stderr and `-q` suppresses it.\n2. **Empty results may be `null`.** Some hosts return `null` instead of `[]`\n   for zero events. Defensive parsing: `data = json.load(f) or []`.\n3. **Large outputs.** A 3000-event history can be several MB of JSON. For\n   repeated analysis passes, save to disk and use `jq` or load into\n   a Python dict once rather than re-pulling.\n\n## Error handling\n\n| Error | Cause | Resolution |\n|---|---|---|\n| Exit code 2, unsupported format | `-O short` or `-O template` passed to `history` | Use `json`, `yaml`, or `tree` instead |\n| `[Threat Hunting Required]` (or similar entitlement error) | Certificate history requested without Threat Hunting module access | Confirm module entitlement, or fall back to host\u002Fweb-property history if the cert itself isn't the actual target |\n| Slow response \u002F rate limited | Window too wide (e.g. `1y`) or too many concurrent history pulls | Start with `--duration 7d`, confirm the signal is there, then widen incrementally rather than jumping straight to a multi-year pull. See Performance characteristics above for expected times. |\n| Empty result set | No events in the requested window | Widen the window, or confirm the asset had any Censys-observed activity at all via `censys view` first |\n\n## Caveats\n\n- History events are diffs against the prior observed state, not full\n  snapshots — don't assume every field is repeated on every event. Use\n  `censys view --at-time` when a complete point-in-time record is needed.\n- Wide time windows are slow and count more heavily against rate limits. Widen\n  incrementally (`7d` → `30d` → `90d`) rather than defaulting to a large window.\n- GeoIP\u002Flocation events reflect registry and geolocation data, which can lag or\n  be imprecise — corroborate an apparent \"location change\" with the\n  accompanying AS change before treating it as a strong reassignment signal.\n- Labels and event classifications are Censys-derived heuristics; treat them as\n  triage aids, not ground truth, especially for attribution calls.\n- **A port can be absent from the whole event stream and still be open.** The\n  history stream does not always cover every port on a host. A port can produce\n  zero events across a full year — no success events and no failure events — while\n  `censys view` shows the same port scanned on the same day, with a complete\n  banner. Absence of events is not evidence that the service was down or\n  intermittent.\n\n  Confirm coverage before you make any claim about when a service started, stopped,\n  or flapped:\n\n  ```bash\n  # ports present in the history stream\n  jq -r '[.[].service_scanned.scan.port] | unique' history.json\n  # ports open right now\n  jq -r '[.[0].services[].port] | sort' view.json\n  ```\n\n  If a port is in the second list but not the first, the history stream does not\n  cover that port. State this as an instrumentation gap. Two consequences follow:\n\n  1. First-seen dates from history are a **lower bound**, and they are anchored\n     only to the ports the stream does cover.\n  2. Do not report the gap as intermittent service. A real case: ports 8085–8087\n     produced zero events across one year on five of six C2 hosts, while the\n     current snapshot showed all three ports scanned that morning. Reading the gap\n     as intermittent C2 would have been a false finding.\n\n## Cross-references\n\n- For a single point-in-time snapshot (including `--at-time` on a specific\n  date), see `censys-view`.\n- For post-retrieval analysis of saved timeline JSON — jq recipes, SQLite\n  loading, batch cert correlation, cross-referencing multiple assets — see\n  `censys-analyze`.\n- For the broader investigation workflow this fits into, see\n  `censys-investigate`.\n",{"name":5,"version":24,"description":7},"0.1.0","main","cc048d5e7a4bcba276bd9b76ef9521a4a9a301bb","skills\u002Fcensys-timeline",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-timeline",{"tool":41,"command":42},"bunx","bunx skills add censys\u002Fcensys-ai-skills --skill censys-timeline",{"tool":44,"command":45},"pnpm","pnpm dlx skills add censys\u002Fcensys-ai-skills --skill censys-timeline","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-timeline\u002FSKILL.md",true,[49],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcli-globals.md","REFERENCE","参考文档",1977,"https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-timeline\u002Freferences\u002Fcli-globals.md",[56,63,70,77,84,91],{"skillNo":57,"name":58,"nameZh":6,"description":59,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":60,"categories":61,"keywords":62,"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":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"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":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"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":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"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":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"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",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":19},"01M7BJ8F7GX9AS741AVVP7QRKJ","censys-cenql","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.","https:\u002F\u002Fgithub.com\u002Fcensys\u002Fcensys-ai-skills\u002Fblob\u002Fmain\u002Fskills\u002Fcensys-cenql\u002FSKILL.md",[],[]]