SeekYou

15の情報源にわたる統合ホストインテリジェンス — 任意のIP、ドメイン、ASNをクエリして、セキュリティ態勢、インフラ詳細、脅威相関を即座に取得。Cloudflareの無料枠のみで動作します。

ライブURL: swiy.co/seekyou``` $ curl "https://seekyou.seekyou.workers.dev/api/lookup?q=1.1.1.1"

{ "query": { "raw": "1.1.1.1", "type": "ip", "normalised": "1.1.1.1" }, "core": { "internetdb": { "status": "ok", "data": { "ports": [80,443], "vulns": [] } }, "geo": { "status": "cached", "data": { "country": "US", "org": "AS13335 Cloudflare" } }, "bgp": { "status": "ok", "data": { "name": "CLOUDFLARENET", "rir": "ARIN" } }, ... }, "meta": { "durationMs": 312, "cacheHits": 4, "sourcesQueried": 15, "sourcesFailed": 0 } }

## スクリーンショット

<div align="center">

### ランディングページ
<img src="https://assets.kitploit.com/production/public/readmes/7467/e00ec4ba8b3e5460ae1e03360cf6540e58d92acc5522c8693445512b591fed29.png" alt="SeekYou 結果ページ" width="800" />


### 結果ページ
<img src="https://assets.kitploit.com/production/public/readmes/7467/09b165feca9927ad4cd50c3ebd28c72e09a0355d72b9ca14d795bf1d04448c92.png" alt="SeekYou ランディングページ" width="800" />

### デモ
<a href="https://www.youtube.com/watch?v=b86tAUUqd34">
  <img src="https://assets.kitploit.com/production/public/readmes/7467/8762e8b464816b9a69d929514441f8c7ee9f9ee9719f95b9c5e33ac1672575f8.jpg" alt="SeekYou デモ" width="800" />
</a>

</div>

---

## 目次

- [SeekYou](#seekyou)
  - [スクリーンショット](#screenshots)
    - [ランディングページ](#landing-page)
    - [結果ページ](#results-page)
    - [デモ](#demo)
  - [目次](#table-of-contents)
  - [SeekYouの機能](#what-seekyou-does)
  - [ユースケース](#use-cases)
  - [合法的使用ポリシー](#lawful-use-policy)
  - [関連ツール](#related-tools)
  - [アーキテクチャ概要](#architecture-overview)
  - [実行モデル](#execution-model)
  - [データソース](#data-sources)
  - [プロジェクト構造](#project-structure)
  - [主要な設計判断](#key-design-decisions)
    - [エッジファースト、Node.js不使用](#edge-first-no-nodejs)
    - [階層型並列実行](#layered-parallel-execution)
    - [グレースフルデグラデーション](#graceful-degradation)
    - [D1 + KVストレージの分割](#split-d1--kv-storage)
    - [Free プラン最適化](#free-tier-optimization)
    - [Fire-and-forget D1書き込み](#fire-and-forget-d1-writes)
  - [キャッシュ戦略](#caching-strategy)
  - [レート制限](#rate-limiting)
  - [サーキットブレーカー](#circuit-breakers)
  - [キーローテーション — GrayHatWarfare](#key-rotation--grayhatwarfare)
  - [D1永続化](#d1-persistence)
    - [スキーマ（`schema.sql`）](#schema-schemasql)
    - [スキーマの適用](#apply-schema)
    - [ヘルパー関数](#helper-functions)
  - [Cron Worker](#cron-worker)
    - [型付き差分（`lib/diff.ts`）](#typed-diff-libdiffts)
    - [Webhookペイロード](#webhook-payload)
  - [開発環境のセットアップ](#development-setup)
    - [前提条件](#prerequisites)
    - [ローカル開発](#local-development)
    - [Cloudflareリソースの作成（初回）](#create-cloudflare-resources-first-time)
  - [デプロイ](#deployment)
    - [ビルドとデプロイ](#build-and-deploy)
    - [Wrangler設定（`wrangler.toml`）](#wrangler-configuration-wranglertoml)
  - [シークレットと環境変数](#secrets-and-environment-variables)
    - [必要なシークレット](#required-secrets)
    - [`.env.example`（ローカル開発のみ）](#envexample-local-dev-only)
  - [ライセンス](#license)
  - [著者](#author)
  - [謝辞](#acknowledgments)

---

## SeekYouの機能

SeekYouは**ホストインテリジェンスツール**です。IPアドレス、ドメイン名、ASNを貼り付けると、以下の統一レポートを取得できます。

| カテゴリ | 取得内容 |
|---|---|
| ネットワーク | オープンポート、CPE、BGPプレフィックス、アップストリーム、ピア、RIR |
| アイデンティティ | RDAP登録情報、連絡先、レジストラ、ネームサーバー |
| 地理情報 | 国、都市、ISP、プロキシ/ホスティング/モバイルフラグ |
| 証明書 | crt.sh履歴、SAN、発行者チェーン |
| DNS | Passive DNSレコード、Robtex逆引き/正引きDNS |
| 脅威 | URLhaus、ThreatFox、MalwareBazaar、Feodo、SSLBL |
| CVE | InternetDBが報告するCVE IDごとにNVD + CIRCLでエンリッチメント |
| 偵察 | GrayHatWarfareによる公開バケット、Wayback CDXスナップショット |

すべてのソースは並列でクエリされます。障害が発生したソースは「利用不可」バッジに切り替わり、ページが壊れることはありません。

---

## ユースケース

**セキュリティ運用** — ログから不審なIPを迅速にプロファイリングし、IOCを関連付け、公開サービスやCVEを特定し、悪意のあるドメインを追跡します。

**ネットワーク運用** — BGPルーティング、RDAP/WHOIS割り当てデータ、DNS履歴、SSL証明書の変更を検査します。

**ペネトレーションテスト** — ポート/サービス/CPEの列挙、公開バケットの発見、アーカイブページ、サブドメイン、ASNの関係性を調査します。

**脅威インテリジェンス** — C2インフラストラクチャを5つの脅威フィードに対して一度のクエリでチェックします。

**コンプライアンス＆リスク** — ベンダーインフラをプロファイリングし、公開クラウドストレージを検出し、シャドーITを特定します。

---

## 合法的使用ポリシー

SeekYouは**合法的なセキュリティ研究、ネットワーク運用、脅威インテリジェンス**のために設計されています。本ツールを使用することにより、以下の条件に同意したものとみなします。

**許可される使用:**
- 自身が所有する、または監視を許可されたネットワークにおけるセキュリティ運用およびインシデント対応
- 脅威インテリジェンス研究およびIOCの関連付け
- 組織内のネットワークトラブルシューティングおよびインフラ監査
- 対象組織からの明示的な書面による許可を得たペネトレーションテスト
- サイバーセキュリティにおける学術研究および教育
- 適切な許可を得たコンプライアンス監査およびベンダーリスク評価

**禁止される使用:**
- 所有していない、またはテストする明示的な許可がないシステムへの不正アクセス、偵察、攻撃
- 個人または組織に対する嫌がらせ、ストーカー行為、プライバシー侵害
- 詐欺、不正アクセス、サイバー犯罪を含む違法行為の幇助
- 許可なくセキュリティ制御やアクセス制限を回避する行為
- CFAA（米国）、Computer Misuse Act（英国）、GDPR（EU）、または管轄区域における同等の法律を含む、適用される法律への違反

**あなたの責任:**
- 所有していないインフラに対してクエリを実行する前に、適切な許可を取得してください
- レート制限を尊重し、サービスや上流のデータソースを乱用しないでください
- 管轄区域のすべての該当法令を遵守してください
- データを責任を持って使用し、調整された開示なしに調査結果を武器化しないでください
- ホストにクエリを実行しても、そのホストにアクセスしたり悪用したりする許可は与えられないことを理解してください

**免責事項:**
本ツールの不正使用について、著者および貢献者は一切の責任を負いません。ユーザーは自身の活動が適用される法律に準拠していることを確認する単独の責任を負います。公開ソースから集約されたデータは、不完全、古い、または不正確である可能性があります。行動を起こす前に、常に信頼できる経路を通じて調査結果を確認してください。

SeekYouを通じて脆弱性を発見した場合は、責任ある開示の慣行に従い、公開開示の前に影響を受ける関係者に通知してください。

---

## 関連ツール

SeekYouはプライバシー重視のセキュリティツールキットの一部です。完全なスイートをご覧ください。

| ツール | 説明 | ライブURL |
|---|---|---|
| **TimeSeal** | 暗号学的タイムスタンプサービス — コンテンツを公開せずに、特定の時点での書類の存在を証明 | [timeseal.online](https://timeseal.online) |
| **SanctumVault** | ゼロ知識暗号化ボールト — 機密データ保存のためのクライアント側暗号化 | [sanctumvault.online](https://sanctumvault.online) |
| **GhostChat** | 一時的な暗号化メッセージング — サーバーログなしで自己破壊する会話 | [ghost-chat.pages.dev](https://ghost-chat.pages.dev) |
| **XMRProof** | Monero支払い検証 — XRMトランザクションの暗号学的証明を生成 | [xmrproof.pages.dev](https://xmrproof.pages.dev) |
| **GhostReceipt** | 匿名領収書生成 — 身元を公開せずに検証可能な取引記録を作成 | [ghostreceipt.pages.dev](https://ghostreceipt.pages.dev) |
| **SeekYou** | ホストインテリジェンスアグリゲーター — IP、ドメイン、ASNに対して15のソースを統合したOSINT | [seekyou.seekyou.workers.dev](https://seekyou.seekyou.workers.dev) |
| **HoneypotScan** | ハニーポット検出サービス — デコイシステムを特定し、セキュリティ研究における誤検知を回避 | [honeypotscan.pages.dev](https://honeypotscan.pages.dev) |

すべてのツールはCloudflareのエッジネットワーク上で動作し、プライバシーファーストの設計原則に従っています。

---