SkillAgentSearch skills...

censys

Censys lookups: hosts, certificates, services on the public internet

Install / Use

npx skills add taracodlabs/aiden --skill censys

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Category

Security

Supported Platforms

Universal

Our assessment of censys

censys scores 83/100 on our quality scale, 919th of 1,096 Security skills we index.

Its SKILL.md is 4.0 KB long, well organised into 9 sections with 3 code examples: a solid amount of guidance for an agent.

It has 843 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
18/20
Description
12/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so censys is actively maintained.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

censys compared with similar skills

All 4 of these similar skills score higher than censys; compare them before choosing.

SkillScoreStarsUpdatedFormat
censys (this skill)by taracodlabs838432mo agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
Scraplingby D4Vinci100103.9ktodayMCP Server
crawl4aiby unclecode10087.5ktodayMCP Server

Frequently asked questions

How do I install censys?
Run npx skills add taracodlabs/aiden --skill censys. The install tabs above show the steps for each supported agent.
Which AI agents does censys work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is censys safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is censys still maintained?
The repository was last updated about 2 months ago, so censys is actively maintained.

name: censys description: "Censys lookups: hosts, certificates, services on the public internet" category: security version: 1.0.0 license: Apache-2.0 origin: aiden tags: security, censys, osint, recon, ports, certificates, tls, asset-discovery, internet-scan env_required:

  • CENSYS_API_ID
  • CENSYS_API_SECRET

Censys — Internet Asset Discovery

Censys continuously scans the public internet and indexes detailed metadata about every reachable host: open ports, running services, TLS certificates, and BGP routing information. Complementary to Shodan with different scanner vantage points and richer certificate data.

Requires: CENSYS_API_ID and CENSYS_API_SECRET — free tier at https://search.censys.io/register (0.4 req/sec, 250 queries/month).

When to Use

  • Look up what Censys sees on a specific IP address
  • Discover internet-exposed assets for a given organisation or ASN
  • Investigate TLS certificates — find all hosts sharing a certificate or subject
  • Security audit: verify which services are visible from the public internet
  • User asks "what does Censys show for IP X", "find hosts with this certificate", "look up ASN exposure"

How to Use

Look up a specific host by IP

$ip       = "8.8.8.8"
$id       = $env:CENSYS_API_ID
$secret   = $env:CENSYS_API_SECRET
$b64      = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("${id}:${secret}"))
$headers  = @{ Authorization = "Basic $b64" }

$result = Invoke-RestMethod -Uri "https://search.censys.io/api/v2/hosts/$ip" -Headers $headers
$r      = $result.result
Write-Host "IP:           $($r.ip)"
Write-Host "AS:           $($r.autonomous_system.name) (ASN $($r.autonomous_system.asn))"
Write-Host "Country:      $($r.location.country)"
Write-Host "Open ports:"
$r.services | ForEach-Object {
    Write-Host "  $($_.port)/$($_.transport_protocol) — $($_.service_name)"
}

Search with a query string

$query    = "services.service_name: HTTP and location.country_code: IN"
$b64      = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("$($env:CENSYS_API_ID):$($env:CENSYS_API_SECRET)"))
$headers  = @{ Authorization = "Basic $b64" }
$encoded  = [Uri]::EscapeDataString($query)

$result = Invoke-RestMethod -Uri "https://search.censys.io/api/v2/hosts/search?q=$encoded" -Headers $headers
Write-Host "Total matches: $($result.result.total)"
$result.result.hits | Select-Object -First 10 | ForEach-Object {
    Write-Host "  $($_.ip) — $($_.autonomous_system.name) ($($_.location.country_name))"
}

Look up a TLS certificate by SHA-256 fingerprint

$sha256  = "YOUR_CERT_SHA256_HERE"
$b64     = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("$($env:CENSYS_API_ID):$($env:CENSYS_API_SECRET)"))
$headers = @{ Authorization = "Basic $b64" }

$result = Invoke-RestMethod -Uri "https://search.censys.io/api/v2/certificates/$sha256" -Headers $headers
$parsed = $result.result.parsed
Write-Host "Subject:   $($parsed.subject_dn)"
Write-Host "Issuer:    $($parsed.issuer_dn)"
Write-Host "Valid:     $($parsed.validity.start) → $($parsed.validity.end)"
Write-Host "SANs:      $($parsed.names_from_san -join ', ')"

Examples

"What is exposed on IP 1.2.3.4?" → Host lookup: returns open ports, service names, ASN, and location.

"Find all exposed Redis servers in Germany" → Query: services.service_name: REDIS and location.country_code: DE

"Who else uses this TLS certificate?" → Certificate lookup by SHA-256 fingerprint — shows SAN names and validity.

"Show me all hosts in ASN 15169" → Query: autonomous_system.asn: 15169

Cautions

  • Free tier: 250 queries/month, 0.4 req/sec — pace bulk operations with Start-Sleep -Milliseconds 2500
  • Censys data reflects last scan date — real-time state may differ
  • Host lookup counts against your monthly quota
  • Certificate search may return expired or revoked certs — check validity dates
  • Never use Censys results to attempt unauthorised access; recon and awareness only

Requirements

  • CENSYS_API_ID and CENSYS_API_SECRET — free account at https://search.censys.io/register

Related Skills

View on GitHub
GitHub Stars843
CategorySecurity
Updated2mo ago
Forks147

Languages

TypeScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions