Wajid16/Khoji
GitHub: Wajid16/Khoji
Khoji 是一款 OSINT 人物搜索 Web 应用，通过单次查询聚合 LinkedIn、Facebook 和 Twitter/X 上的公开个人资料，解决跨平台人物信息检索的效率问题。
Stars: 0 | Forks: 0
# Khoji — OSINT 人物搜索 🔍
**Khoji** 是一款高级的 OSINT（开源情报）Web 应用程序，只需一次搜索查询，即可跨 **LinkedIn**、**Facebook** 和 **Twitter/X** 查找人物。它汇总公开的个人资料数据，并在简洁、统一的界面中展示结果。
## ✨ 功能
- **多平台搜索** — 同时搜索 LinkedIn、Facebook 和 Twitter
- **智能过滤** — 按姓名、地点、大学和公司过滤结果
- **详细资料视图** — 点击任意结果，打开包含直接资料链接的丰富详情弹窗
- **用户身份验证** — 注册/登录，支持会话持久化
- **深色与浅色模式** — 感知系统主题的切换功能，过渡平滑
- **响应式设计** — 针对桌面端和移动端进行全面优化
- **精美的 UI** — 采用 Glassmorphism 设计、动态色块和 Framer Motion 过渡效果
## 📷 截图
### 搜索与结果界面
### 详细资料视图
## 🛠️ 技术栈
| 层级 | 技术 |
|-------|-----------|
| **前端** | React 19, Vite 7 |
| **样式** | Tailwind CSS 4, Framer Motion |
| **图标** | Lucide React |
| **后端** | N8N Workflow Automation |
| **搜索 API** | Google Custom Search (via N8N) |
## 📦 快速开始
### 前置条件
- Node.js 18+
- npm
### 安装
```
git clone https://github.com/Wajid160/PersonFinder-FYP.git
cd PersonFinder-FYP
npm install
```
### 配置
在项目根目录下创建一个 `.env` 文件（可选 — 默认回退到备用 endpoint）：
```
VITE_N8N_WEBHOOK_URL=https://your-n8n-instance.com/webhook/person-finder
```
### 运行开发服务器
```
npm run dev
# 打开于 http://localhost:5173
```
### 构建生产版本
```
npm run build
```
## 🏗️ 项目结构
```
src/
├── components/
│ ├── Auth/ # Login & Signup modals
│ ├── Results/ # ResultCard & PersonDetailModal
│ ├── Search/ # SearchBar with advanced filters
│ └── UI/ # LoadingOverlay with step animation
├── context/
│ └── AuthContext.jsx # Authentication state management
├── services/
│ └── api.js # N8N webhook integration & data transform
├── App.jsx # Root component
├── index.css # Tailwind + design tokens (light/dark)
└── main.jsx # Entry point
docs/
├── n8n-workflow.json # Importable N8N workflow file
├── n8n-workflow.png # Visual workflow diagram
└── ... # Project screenshots
```
## ⚙️ 后端 (N8N)
搜索后端由 N8N workflow 提供支持，负责统筹协调 Google Custom Search API 请求。
### Workflow 逻辑
1. 通过 webhook 接收搜索查询
2. 针对每个平台运行优化过的 Google 搜索 (`site:linkedin.com/in`, `site:facebook.com`, `site:twitter.com`)
3. 解析并结构化结果
4. 返回分类后的 JSON：`{ linkedin: [...], facebook: [...], twitter: [...] }`
### 搭建你自己的后端
1. 创建一个 N8N 实例（自托管或云端）
2. 导入 workflow 文件：[docs/n8n-workflow.json](docs/n8n-workflow.json)
3. 在 N8N 中设置 **Google Custom Search API** 凭据
4. 使用你的 `CX` (Search Engine ID) 和 API key 凭据配置 Google Search 节点
5. 在你前端的 `.env` 文件中设置 webhook URL
## 📄 许可证
MIT — 由 **Wajid Javed** 构建
标签：ESC4, N8N, OSINT, React, Syscalls, 安全研发, 实时处理, 数据泄露, 网络情报, 自定义脚本