IPクロール:公開インターネット上で発見されたオープンウェブカメラの生きたアトラス
IP Crawl: living atlas of open webcams discovered on the public internet (ipcrawl.com)
要約
このサイトは、インターネット上で公開されているウェブカメラを探索するための「生きたアトラス」を提供しています。世界中の様々な場所にある無数のウェブカメラにアクセスし、リアルタイムの映像や情報を得ることができます。
全文翻訳
Folders and files
IP Crawl (ipcrawl.com)
公開インターネットインテリジェンスを通じて発見されたオープンウェブカメラのフィルタリング可能なカタログとライブプレビューサーフェス。
[画像: IP Crawl Explore UI — フィルタリング可能なカメラカタログ、地図、統計情報、ライブプレビュー]
IP Crawlとは?
IP Crawlは、公開インターネットインテリジェンスソース(現在はShodan)を通じて発見されたオープンウェブカメラのデータをサーフェス化します。以下の機能を提供します。
- カタログ (
/、「Explore」) — 国、都市、組織、メーカー、稼働状況、またはフリーテキスト検索で数千台のカメラを閲覧できます。カメラを開くと、より大きなライブまたは静止プレビューが表示されます。 - Fun Mode (
/fun) — Guess Mode、スクリーンセーバー、ライブのみのフィルタリング、共有可能なチャンネルURL(/fun/c/[id])を備えたCRTスタイルのランダムチャンネルビューアです。これはオリジナルのPOCでした。 - マップ (
/map) — カメラ位置をクラスター化されたマーカーで空間的に表示します。 - 統計 (
/stats) — 集計メトリクスと12ヶ月のトレンドチャートを表示します。 - API (
/api) — 公開APIのドキュメント(現時点では1つのCORSオープンエンドポイント)です。 - 「私のカメラは露出していますか?」 (
/imce) — 訪問者のIPがカタログに表示されているかどうかを確認する、一般消費者向けのスキャンです。ismycameraexposed.com。
このプロジェクトは、全てのオープンウェブカメラを保護し、オープンウェブカメラの総数をゼロにするというミッションを持っています。ミッションの詳細についてはこちらをお読みください。
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Nuxt 4 (Vue 3.5, Nitro 2) |
| Styling | Tailwind CSS 4 + Nuxt UI 4 |
| Icons | Iconify (Lucide + Simple Icons) |
| Maps | Leaflet |
| Markdown | marked |
| Runtime | Node.js (VPS, systemd + nginx) |
| Storage | SQLite (node:sqlite) + filesystem |
| Testing | Playwright (E2E) |
| CI | GitHub Actions |
Quick Start
# Clone and install
git clone https://github.com/iptv-crawler/ipcrawl.git
cd ipcrawl
pnpm install
# Configure your Shodan API key
cp .env.example .env
# Edit .env — add your NUXT_SHODAN_API_KEY
# Start the dev server (local SQLite)
pnpm run dev
開発サーバーは http://localhost:3000 で実行されます。ストレージはデフォルトでローカルファイルシステム(./.data/)に設定されているため、ローカルでカタログを閲覧できます。
Environment Variables
| Variable | Default | Description |
|---|---|---|
NUXT_SHODAN_API_KEY | — | Shodan APIキー(カメラの更新に必要) |
NUXT_SHODAN_LIMIT_PER_QUERY | 1500 | Shodanクエリページあたりの最大カメラ数 |
NUXT_EDGE_KILL_SWITCH | false | 緊急停止スイッチ — ライブプローブをスキップし、キャッシュされたスクリーンショットを提供します |
NUXT_OFFLINE_FOR_NOW | false | 全てのトラフィックをオーバーロードページにリダイレクトします |
NUXT_ENABLE_LIVE_PROBE | false | ライブカメラフレームの取得を有効にします |
Architecture
app/ Root app shell, global theme, error pages
├── layers/
│ ├── explore/ Catalog UI at / (grid, sidebar, dialog)
│ ├── fun/ CRT roulette at /fun (random channel viewer)
│ ├── imce/ "Is My Camera Exposed?" scan at /imce
│ └── map/ Map explorer at /map
├── server/ Shared Nitro handlers, camera ingestion, live probing
├── shared/ API contracts (shared between client & server)
└── migrations/ Database migrations
Key API Routes
| Route | Description |
|---|---|
GET /api/explore/cams | Paginated catalog list (SWR 30s) |
GET /api/explore/facets | Cross-filtered facet counts (SWR 10m) |
GET /api/explore/cams/[id] | Single camera detail |
POST /api/explore/favorite/[id] | Per-IP deduped favorite vote |
GET /api/explore/thumb/[id].jpg | Cached still thumbnail |
GET /api/cam | Random camera for Fun mode (uncached) |
GET /api/ip | Public, CORS-open exposure check for the requesting IP (browser-cached 5 min) |
GET /api/live/[id].jpg | Live frame proxy with screenshot fallback |
GET /api/status | Refresh diagnostics |
Refresh Pipeline
スケジュールされたタスク(server/tasks/cams/refresh.ts)が毎日00:00 UTCに実行されます。
- キャッシュされたカメラをブロックリストに対してスクラブします。
- Shodan REST API(ページネーションあり)をクエリします。
ip:portで重複を排除し、ブロックされた行をドロップします。- スクリーンショットバイトをファイルシステムに書き込みます。
- メタデータをSQLiteにアップサートします。
- 保留期間を過ぎた古い行を削除します。
Deployment
pnpm run build
node .output/server/index.mjs
完全なVPSプロビジョニングスクリプト(systemdユニット、nginx設定、バックアップタイマー)については、deploy/を参照してください。
Contributing
貢献を歓迎します!プルリクエストを開く前に、CONTRIBUTING.md をお読みください。
Key Rules
-
Human-operated accounts only — ボットアカウント、AIエージェントアカウント、自動化スクリプトは貢献できません。これはCIで強制されます。
-
Behavior-only test coverage required — アプリケーションコードを変更する全てのPRには、変更された動作を実行する少なくとも1つのPlaywright E2EスペックまたはAPI統合スペックを含める必要があります。
-
Open an issue first — 些細な修正以上のものについては、まずイシューを開いてください。
Running Tests
pnpm run lint # ESLint
pnpm run typecheck # TypeScript type checking
pnpm run test:e2e # Playwright E2E tests
pnpm run test:e2e:ui # Playwright with interactive UI
PRがマージされる前に、全てのチェックに合格する必要があります。CIは、全てのPRに対してlint、typecheck、E2Eテスト、人間アカウント検証、および動作テストカバレッジチェックを実行します。
License
MIT © Alec Armbruster