# Send OSINT Social Analyzer to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "osint-social",
    "name": "OSINT Social Analyzer",
    "source": "tencent",
    "type": "skill",
    "category": "其他",
    "sourceUrl": "https://clawhub.ai/guleguleguru/osint-social",
    "canonicalUrl": "https://clawhub.ai/guleguleguru/osint-social",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/osint-social",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=osint-social",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "README.zh.md",
      "SKILL.md",
      "scripts/cn_lookup.py",
      "scripts/run_osint.sh",
      "references/platforms.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "osint-social",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T07:45:58.995Z",
      "expiresAt": "2026-05-06T07:45:58.995Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=osint-social",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=osint-social",
        "contentDisposition": "attachment; filename=\"osint-social-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "osint-social"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/osint-social"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/osint-social",
    "downloadUrl": "https://openagent3.xyz/downloads/osint-social",
    "agentUrl": "https://openagent3.xyz/skills/osint-social/agent",
    "manifestUrl": "https://openagent3.xyz/skills/osint-social/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/osint-social/agent.md"
  }
}
```
## Documentation

### OSINT Social Analyzer Skill

Cross-platform username investigation using social-analyzer.
Searches 1000+ platforms and returns a natural language summary of findings.

### Setup (first run only)

pip3 install social-analyzer --break-system-packages

Verify it works:

python3 -m social-analyzer --username "testuser" --top 10 --output json --filter "good"

### Standard lookup (recommended default)

python3 -m social-analyzer \\
  --username "{USERNAME}" \\
  --metadata \\
  --output json \\
  --filter "good" \\
  --top 100

### Deep lookup (slower, more thorough)

python3 -m social-analyzer \\
  --username "{USERNAME}" \\
  --metadata \\
  --extract \\
  --output json \\
  --filter "good,maybe" \\
  --top 300

### Platform-specific lookup

# Specific websites
python3 -m social-analyzer --username "{USERNAME}" --websites "youtube twitter instagram tiktok github"

# By content type
python3 -m social-analyzer --username "{USERNAME}" --type "music"

# By country
python3 -m social-analyzer --username "{USERNAME}" --countries "us uk"

### Multiple usernames (variants)

python3 -m social-analyzer --username "{NAME1},{NAME2},{NAME3}" --metadata --top 100

### Parsing and Summarizing Results

After running the command, parse the JSON output and produce a conversational summary — do NOT dump raw JSON to the user.

### What to extract from results

From each detected profile:

website — platform name
url — direct link
rate — confidence score (0–100)
status — "good" / "maybe" / "bad"
metadata.name — display name if available
metadata.bio — bio/description if available
metadata.followers — follower count if available

### Summary format (conversational, natural language)

Structure the response like this:

找到 [N] 个账号，以下是主要发现：

**高置信度账号（rate ≥ 80）：**
- GitHub (rate: 95): github.com/username — 显示名 "John"，有 234 个 follower
- Twitter (rate: 88): twitter.com/username
- Instagram (rate: 82): instagram.com/username — 简介：摄影爱好者

**中等置信度（rate 50–79）：**
- Reddit (rate: 65): reddit.com/u/username

共扫描了 100 个平台，[M] 个请求失败（网络超时等），不影响主要结果。

### Confidence tiers

rate ≥ 80 → 高置信度，几乎确定是同一人
rate 50–79 → 中等，值得关注但需人工确认
rate < 50 → 低，通常跳过，除非用户要求显示全部

### Handling Edge Cases

No results found:

在扫描的 100 个平台中未找到该用户名的公开账号。可能原因：用户名拼写不同、账号已删除、或平台设置了隐私保护。

Command takes too long (>5 min):
Reduce scope: --top 50 or specify --websites explicitly.

pip install fails:

pip3 install social-analyzer
# or
pip install social-analyzer --user

Rate limiting from platforms:
Some platforms block rapid scanning. Use --mode slow for more polite requests:

python3 -m social-analyzer --username "{USERNAME}" --mode slow --top 50

### Privacy & Ethics Reminder

This tool only accesses publicly available information.

Always remind the user:

Results are public data only — no private messages, emails, or passwords
Intended for legitimate use: self-auditing, security research, journalism, law enforcement support
Do not use to stalk, harass, or violate anyone's privacy
Different jurisdictions have different laws around OSINT — use responsibly

Include a one-line reminder at the end of every investigation summary:

⚠️ 以上均为公开信息，请合法合理使用。

### Chinese Platform Lookup (cn_lookup.py)

For Chinese social media platforms, use the dedicated script instead of social-analyzer.

### Supported platforms

平台覆盖情况备注Bilibili 哔哩哔哩✅ 用户名搜索 + 主页信息最可靠知乎 Zhihu✅ 用户名/URL token 搜索需精确匹配微博 Weibo⚠️ 移动端降级搜索仅存在性检测小红书 / 抖音 / 微信❌ 不支持强制登录，无公开接口

### Running cn_lookup

python3 skills/osint-social/scripts/cn_lookup.py "{USERNAME}"

### When to use cn_lookup vs social-analyzer

User mentions Chinese platforms, Bilibili, 知乎, 微博 → use cn_lookup.py
User mentions username is Chinese or used on Chinese internet → run both
General global lookup → use social-analyzer only

### Combined workflow (recommended for thorough investigation)

# Step 1: Global platforms
python3 -m social-analyzer --username "{USERNAME}" --metadata --output json --filter "good" --top 100

# Step 2: Chinese platforms
python3 skills/osint-social/scripts/cn_lookup.py "{USERNAME}"

Then combine and summarize both outputs together in a single natural language response.

### Reference Files

references/platforms.md — Notable platforms covered and their categories
references/platforms.md — Notable platforms covered and their categories
scripts/run_osint.sh — Shell wrapper for global platform lookup
scripts/cn_lookup.py — Chinese platform lookup (Bilibili, Zhihu, Weibo)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: guleguleguru
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T07:45:58.995Z
- Expires at: 2026-05-06T07:45:58.995Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/osint-social)
- [Send to Agent page](https://openagent3.xyz/skills/osint-social/agent)
- [JSON manifest](https://openagent3.xyz/skills/osint-social/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/osint-social/agent.md)
- [Download page](https://openagent3.xyz/downloads/osint-social)