censys
Censys lookups: hosts, certificates, services on the public internet
Install / Use
npx skills add taracodlabs/aiden --skill censysInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
SecuritySupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| censys (this skill)by taracodlabs | 83 | 843 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP 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.
Skill content
View source on GitHubname: 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_IDandCENSYS_API_SECRET— free account at https://search.censys.io/register
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
