specific-ai-cli 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cv-cat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+<img src="assets/hero.svg" width="100%" alt="Specific AI — One command. Every platform.">
+
+<br>
+
+**One command. Ten platforms.**<br>
+RedNote (Xiaohongshu) · Douyin · TikTok · Bilibili · Kuaishou · Weibo · Xianyu · Taobao · JD.com · X
+<br>
+<sub>Coming soon: Instagram · YouTube · Facebook · Zhihu · WeChat Official Accounts · Toutiao · Poizon (Dewu) · Pinduoduo · Meituan · Dianping</sub>
+
+<br>
+
+[![npm](https://img.shields.io/npm/v/specific-ai-cli?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/specific-ai-cli)
+[![License: MIT](https://img.shields.io/badge/license-MIT-A6E3A1?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](tsconfig.json)
+[![Platforms](https://img.shields.io/badge/platforms-10-F38BA8?style=for-the-badge)](docs/platforms/README.md)
+[![Agent Ready](https://img.shields.io/badge/AI%20Agent-ready-CBA6F7?style=for-the-badge)](.claude/skills/specific-ai/SKILL.md)
+
+[简体中文](README.md) · **English** · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
+
+[Quick start](docs/guide/quick-start.md) · [Capabilities](docs/capabilities.md) · [Platforms](docs/platforms/README.md) · [Examples](docs/examples/README.md) · [For agents](.claude/skills/specific-ai/SKILL.md)
+
+</div>
+
+<br>
+
+> Every platform has its own APIs, request signing, login flow, and data format. **Specific AI brings them into one interface**: one command vocabulary, one JSON shape, and one home for your logins. To switch platforms, change a single word.
+
+
+## ✨ What is Specific AI
+
+Specific AI is a command-line tool that drives the web endpoints of 10 major Chinese and global platforms through **one unified syntax**: search, details, comments, users, feeds, downloads, publishing, direct messages, live-stream chat and more.
+
+```bash
+specific-ai xhs      item search 露营 --sort latest
+specific-ai douyin   item search 露营 --sort latest
+specific-ai bilibili item search 露营 --sort latest
+specific-ai x        item search camping --sort latest
+```
+
+Four platforms, four nearly identical commands, and JSON output with **the same structure**. Notes, posts, videos and tweets are all just `item`; searching is always `search`; liking is always `like`. Learn it once, and you can use all ten platforms.
+
+<p align="center">
+  <img src="assets/platforms.svg" width="100%" alt="10 supported platforms and 10 more in progress">
+</p>
+
+## 🚀 Why Specific AI
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🧭 Same meaning, same name
+A capability that means the same thing uses **the same command, the same options and the same output** on every platform. Reach for a platform's native term (`note`, `aweme`, `tweet`…) and specific-ai will tell you which word to use instead.
+
+</td>
+<td width="50%" valign="top">
+
+### 📦 Node is all you need
+No Python, no compiler, no system dependencies. Every native dependency ships prebuilt binaries covering x64 / arm64 on Windows, macOS and Linux (musl included), and all **8 target systems** are smoke-tested one by one in CI.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🤖 Built for AI agents
+stdout carries nothing but JSON, exit codes are stable, and errors come with the next command to run. `specific-ai platforms` prints the complete list of capabilities. Ships with an [agent skill](.claude/skills/specific-ai/SKILL.md) and [llms.txt](llms.txt).
+
+</td>
+<td valign="top">
+
+### 🔐 Your logins never leave your machine
+QR code, SMS and cookie import are all supported. Credentials are isolated per **platform × endpoint × account** under `~/.specific-ai/` (0700 / 0600), and you can switch between accounts at any time. No data is collected or uploaded, and there is no telemetry.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🧪 Byte-for-byte faithful to upstream
+The URL, header order, cookies, body and signature of every request are **compared byte for byte** against the upstream implementation, with randomness and the clock pinned. 560+ golden files and 940+ offline tests guard every change.
+
+</td>
+<td valign="top">
+
+### 🛡️ A browser-grade network stack
+TLS / HTTP2 fingerprints that match real Chrome, upstream signing JS running unmodified in a sandbox, and slider and click-to-select CAPTCHAs solved automatically with local ONNX and OpenCV.
+
+</td>
+</tr>
+</table>
+
+## 📊 By the numbers
+
+<div align="center">
+
+| 🚌 Platforms | ⌨️ Implemented commands | 🧪 Golden files | ✅ Offline tests | 💻 Target systems |
+|:---:|:---:|:---:|:---:|:---:|
+| **10** | **300+** | **560+** | **940+** | **8** |
+
+</div>
+
+## 🏗️ Architecture
+
+<p align="center">
+  <img src="assets/architecture.svg" width="100%" alt="specific-ai architecture">
+</p>
+
+- **One registry drives everything**: command parsing, the four levels of `--help`, `specific-ai platforms` and the [capability matrix](docs/capabilities.md) are all generated from the same registry, so they can never contradict each other.
+- **One platform, one set of files**: `client` handles sessions and signing, `api` maps one-to-one onto upstream methods, `normalize` turns raw data into the unified types, and `resolve` lets IDs, links, share short links and `me` all work as arguments.
+- **Extensible**: the spec reserves room for app / pc endpoints; non-JS upstreams will plug in through the provider protocol.
+
+## 🤖 Built for AI agents
+
+specific-ai was designed from day one to be called by programs:
+
+```bash
+specific-ai platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'
+```
+
+- **Self-describing**: the login requirements, implementation status and upstream support of every platform and every command are one command away.
+- **Predictable**: success and failure share the same envelope, `{ ok, data, page, error }`; `error.hint` spells out the next command to run.
+- **Chainable**: every output object carries an `id` and a `url`, so one command's result can be fed straight into the next.
+- **Well-behaved**: dangerous operations require an explicit `-y`, posts can be published as visible only to you, and risk control is reported plainly as `RISK_CONTROL` — never silently retried.
+
+Install the specific-ai skill into Claude Code, Cursor, Codex and other agents with one command:
+
+```bash
+npx skills add Dearli666/specific-ai
+```
+
+The skill loads on demand: a one-page overview, plus [sub-files](.claude/skills/specific-ai/SKILL.md) that are read only when a task touches a given platform or kind of work (collecting, publishing, live & DMs, troubleshooting). Safety rules are built in — logins stay with you, writes need confirmation, posts default to private, and it stops on risk control.
+
+## ⚡ On board in 30 seconds
+
+```bash
+npm i -g specific-ai-cli
+
+specific-ai doctor                 # check your environment
+specific-ai bilibili auth login    # log in by scanning a QR code
+specific-ai bilibili item search 猫 --limit 20
+```
+
+You can also use [Docker](docs/guide/docker.md) or install from source; see [Quick start](docs/guide/quick-start.md) for the full steps.
+
+## 📚 Documentation
+
+The guides below are in Chinese.
+
+| | |
+|---|---|
+| 🚀 [Quick start](docs/guide/quick-start.md) | From installation to your first data export |
+| 🔑 [Login](docs/guide/login.md) · ⚙️ [Configuration](docs/guide/configuration.md) · 🐳 [Docker](docs/guide/docker.md) | QR code / cookies, multiple accounts, proxies, containers |
+| 📤 [Output and errors](docs/guide/output.md) | Envelope, normalized types, pagination, exit codes |
+| 🧭 [Platform guides](docs/platforms/README.md) · 🗂️ [Capability matrix](docs/capabilities.md) | What each platform supports and how to pass arguments |
+| 🧪 [Example scripts](docs/examples/README.md) | Cross-platform search, exporting comments, backing up posts, recording live chat |
+| 📐 [AGENTS.md](AGENTS.md) | The specific-ai spec itself |
+| ❓ [FAQ](docs/guide/faq.md) | Why log in? What to do about risk control… |
+
+## 🤝 Contributing
+
+Issues and PRs are welcome — new platforms, new commands, fixes for platform API changes, documentation improvements, all of it. Before you start, please read [CONTRIBUTING.md](.github/CONTRIBUTING.md) and [AGENTS.md](AGENTS.md) (spec first; every request needs a golden test). Please report security issues privately as described in [SECURITY.md](.github/SECURITY.md).
+
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 [cv-cat](https://github.com/cv-cat)
+
+<div align="center">
+<br>
+<img src="assets/logo.svg" width="64" alt="specific-ai">
+<br>
+<sub>One command. Every platform. · 一个命令，连接每个平台</sub>
+</div>

package/README.ja.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+<img src="assets/hero.svg" width="100%" alt="Specific AI — ひとつのコマンドですべてのプラットフォームへ">
+
+<br>
+
+**ひとつのコマンドで、10 のプラットフォームへ。**<br>
+小紅書（RED） · 抖音 · TikTok · ビリビリ · 快手 · 微博 · 閑魚 · タオバオ · 京東 · X
+<br>
+<sub>まもなく対応：Instagram · YouTube · Facebook · 知乎 · WeChat 公式アカウント · 今日頭条 · 得物 · 拼多多 · 美団 · 大衆点評</sub>
+
+<br>
+
+[![npm](https://img.shields.io/npm/v/specific-ai-cli?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/specific-ai-cli)
+[![License: MIT](https://img.shields.io/badge/license-MIT-A6E3A1?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](tsconfig.json)
+[![Platforms](https://img.shields.io/badge/platforms-10-F38BA8?style=for-the-badge)](docs/platforms/README.md)
+[![Agent Ready](https://img.shields.io/badge/AI%20Agent-ready-CBA6F7?style=for-the-badge)](.claude/skills/specific-ai/SKILL.md)
+
+[简体中文](README.md) · [English](README.en.md) · [繁體中文](README.zh-TW.md) · **日本語** · [한국어](README.ko.md)
+
+[クイックスタート](docs/guide/quick-start.md) · [機能マトリクス](docs/capabilities.md) · [プラットフォーム別](docs/platforms/README.md) · [サンプル](docs/examples/README.md) · [エージェント向け](.claude/skills/specific-ai/SKILL.md)
+
+</div>
+
+<br>
+
+> プラットフォームごとに、API も署名方式も、ログイン方法もデータ形式もバラバラ。**Specific AI はそれらをひとつの入口に統合します**。同じコマンド、同じ JSON、同じログイン情報ディレクトリ。プラットフォームを切り替えるときは、単語をひとつ変えるだけです。
+
+
+## ✨ Specific AI とは
+
+Specific AIは、中国内外の主要 10 プラットフォームの web エンドポイントを**統一された構文**で操作できるコマンドラインツールです。検索、詳細、コメント、ユーザー、おすすめフィード、ダウンロード、投稿、DM、ライブ配信の弾幕コメント……。
+
+```bash
+specific-ai xhs      item search 露营 --sort latest
+specific-ai douyin   item search 露营 --sort latest
+specific-ai bilibili item search 露营 --sort latest
+specific-ai x        item search camping --sort latest
+```
+
+4 つのプラットフォームに、ほぼ同じ 4 つのコマンド。出力される JSON は**すべて同じ構造**です。ノートも作品も動画もポストも、すべて `item`。検索は必ず `search`、いいねは必ず `like`。一度覚えれば、10 のプラットフォームすべてで使えます。
+
+<p align="center">
+  <img src="assets/platforms.svg" width="100%" alt="対応済みの 10 プラットフォームと開発中の 10 プラットフォーム">
+</p>
+
+## 🚀 Specific AI を選ぶ理由
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🧭 同じ意味には、同じ名前
+意味が同じ機能は、どのプラットフォームでも**同じコマンド、同じパラメータ、同じ出力**。プラットフォーム固有の呼び名（`note`、`aweme`、`tweet`……）を使ってしまっても大丈夫。どの単語を使えばいいか、specific-ai が教えてくれます。
+
+</td>
+<td width="50%" valign="top">
+
+### 📦 必要なのは Node だけ
+Python もコンパイラも、システム依存のパッケージも不要です。ネイティブ依存はすべてビルド済みバイナリ付きで、Windows・macOS・Linux の x64 / arm64（musl を含む）をカバー。**8 つのターゲット環境**すべてで、CI がひとつずつスモークテストしています。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🤖 AI エージェントのために生まれた
+stdout には JSON だけ。終了コードは安定していて、エラーには次に実行すべきコマンドが添えられます。`specific-ai platforms` は全機能の一覧を出力します。[エージェント用スキル](.claude/skills/specific-ai/SKILL.md) と [llms.txt](llms.txt) を同梱しています。
+
+</td>
+<td valign="top">
+
+### 🔐 ログイン情報はあなたの PC の中だけに
+QR コード、SMS、cookie のインポートに対応。認証情報は **プラットフォーム × エンドポイント × アカウント** ごとに `~/.specific-ai/`（0700 / 0600）に分けて保存され、複数のアカウントもいつでも切り替えられます。データの収集・送信は一切なく、テレメトリもありません。
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🧪 上流とバイト単位で一致
+すべてのリクエストの URL、ヘッダー順、cookie、body、署名を、乱数と時刻を固定したうえで上流の実装と**1 バイトずつ突き合わせて**います。560+ 件のゴールデンデータと 940+ 件のオフラインテストが、あらゆる変更を見守ります。
+
+</td>
+<td valign="top">
+
+### 🛡️ ブラウザ級のネットワークスタック
+本物の Chrome と一致する TLS / HTTP2 フィンガープリント。上流の署名 JS は手を加えずにサンドボックスで実行し、スライダー型・クリック選択型の CAPTCHA はローカルの ONNX と OpenCV で自動認識します。
+
+</td>
+</tr>
+</table>
+
+## 📊 数字で見る Specific AI
+
+<div align="center">
+
+| 🚌 プラットフォーム | ⌨️ 実装済みコマンド | 🧪 ゴールデンデータ | ✅ オフラインテスト | 💻 ターゲット環境 |
+|:---:|:---:|:---:|:---:|:---:|
+| **10** | **300+** | **560+** | **940+** | **8** |
+
+</div>
+
+## 🏗️ アーキテクチャ
+
+<p align="center">
+  <img src="assets/architecture.svg" width="100%" alt="specific-ai のアーキテクチャ">
+</p>
+
+- **ひとつのレジストリがすべてを動かす**：コマンド解析、4 階層の `--help`、`specific-ai platforms`、[機能マトリクス](docs/capabilities.md) はすべて同じレジストリから生成されるため、互いに食い違うことはありません。
+- **1 プラットフォームに、1 セットのファイル**：`client` はセッションと署名を担当し、`api` は上流のメソッドと 1 対 1 で対応、`normalize` は生データを統一された型に変換し、`resolve` は ID・リンク・共有用短縮 URL・`me` のどれでも引数として使えるようにします。
+- **拡張可能**：仕様には app / pc エンドポイントの枠があらかじめ用意されており、JS 以外の上流は provider プロトコルで接続する予定です。
+
+## 🤖 AI エージェントのために生まれた
+
+specific-ai は最初の日から「プログラムに呼び出される」ことを前提に設計されています。
+
+```bash
+specific-ai platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'
+```
+
+- **自己記述的**：各プラットフォーム・各コマンドのログイン要否、実装状況、上流での対応度合いが、コマンドひとつで分かります。
+- **予測可能**：成功も失敗も同じエンベロープ `{ ok, data, page, error }`。`error.hint` が次に実行すべきコマンドをそのまま示します。
+- **つなげられる**：出力されるオブジェクトはすべて `id` と `url` を持つので、前のコマンドの結果をそのまま次のコマンドに渡せます。
+- **節度がある**：危険な操作には明示的な `-y` が必須。投稿は自分だけに公開することもでき、リスク制御に引っかかったときは `RISK_CONTROL` とはっきり報告して、黙ってリトライすることはありません。
+
+コマンドひとつで、specific-ai スキルを Claude Code・Cursor・Codex などのエージェントに入れられます：
+
+```bash
+npx skills add Dearli666/specific-ai
+```
+
+スキルは必要な分だけ読み込まれます。概要は 1 ページだけで、扱うプラットフォームや作業の種類（収集、投稿、ライブと DM、トラブル対応）に応じて[サブファイル](.claude/skills/specific-ai/SKILL.md)を読みます。安全のルールも組み込み済みです：ログインはあなたに任せる、書き込みは必ず確認、投稿は既定で非公開、リスク制御に当たったら止まる。
+
+## ⚡ 30 秒で乗車
+
+```bash
+npm i -g specific-ai-cli
+
+specific-ai doctor                 # 環境をチェック
+specific-ai bilibili auth login    # QR コードでログイン
+specific-ai bilibili item search 猫 --limit 20
+```
+
+[Docker](docs/guide/docker.md) やソースからのインストールも可能です。詳しい手順は [クイックスタート](docs/guide/quick-start.md) をご覧ください。
+
+## 📚 ドキュメント
+
+以下のドキュメントは中国語（簡体字）で書かれています。
+
+| | |
+|---|---|
+| 🚀 [クイックスタート](docs/guide/quick-start.md) | インストールから最初のデータのエクスポートまで |
+| 🔑 [ログイン](docs/guide/login.md) · ⚙️ [設定](docs/guide/configuration.md) · 🐳 [Docker](docs/guide/docker.md) | QR コード / cookie、複数アカウント、プロキシ、コンテナ |
+| 📤 [出力とエラー処理](docs/guide/output.md) | エンベロープ、正規化された型、ページング、終了コード |
+| 🧭 [プラットフォーム別ガイド](docs/platforms/README.md) · 🗂️ [機能マトリクス](docs/capabilities.md) | 各プラットフォームの対応状況と引数の渡し方 |
+| 🧪 [サンプルスクリプト](docs/examples/README.md) | 横断検索、コメントのエクスポート、投稿のバックアップ、ライブ弾幕の記録 |
+| 📐 [AGENTS.md](AGENTS.md) | specific-ai の仕様そのもの |
+| ❓ [よくある質問](docs/guide/faq.md) | なぜログインが必要？リスク制御に引っかかったら？…… |
+
+## 🤝 コントリビュート
+
+issue も PR も歓迎します。新しいプラットフォーム、新しいコマンド、プラットフォーム側の API 変更への対応、ドキュメントの改善、なんでもどうぞ。始める前に [CONTRIBUTING.md](.github/CONTRIBUTING.md) と [AGENTS.md](AGENTS.md) に目を通してください（仕様が先、リクエストには必ずゴールデンテストを）。セキュリティ上の問題は [SECURITY.md](.github/SECURITY.md) に従って非公開で報告してください。
+
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 [cv-cat](https://github.com/cv-cat)
+
+<div align="center">
+<br>
+<img src="assets/logo.svg" width="64" alt="specific-ai">
+<br>
+<sub>ひとつのコマンドですべてのプラットフォームへ · One command. Every platform.</sub>
+</div>

package/README.ko.md

@@ -0,0 +1,177 @@
+<div align="center">
+
+<img src="assets/hero.svg" width="100%" alt="Specific AI — 하나의 명령으로 모든 플랫폼을 연결">
+
+<br>
+
+**명령어 하나로, 10개 플랫폼까지.**<br>
+샤오훙수 · 더우인 · TikTok · 빌리빌리 · 콰이서우 · 웨이보 · 셴위 · 타오바오 · 징둥 · X
+<br>
+<sub>지원 예정: Instagram · YouTube · Facebook · 즈후 · 위챗 공식 계정 · 진르터우탸오 · 더우 · 핀둬둬 · 메이퇀 · 다중뎬핑</sub>
+
+<br>
+
+[![npm](https://img.shields.io/npm/v/specific-ai-cli?style=for-the-badge&logo=npm&color=CB3837)](https://www.npmjs.com/package/specific-ai-cli)
+[![License: MIT](https://img.shields.io/badge/license-MIT-A6E3A1?style=for-the-badge)](LICENSE)
+[![Node](https://img.shields.io/badge/node-22%20%7C%2024%20%7C%2026-339933?style=for-the-badge&logo=nodedotjs&logoColor=white)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](tsconfig.json)
+[![Platforms](https://img.shields.io/badge/platforms-10-F38BA8?style=for-the-badge)](docs/platforms/README.md)
+[![Agent Ready](https://img.shields.io/badge/AI%20Agent-ready-CBA6F7?style=for-the-badge)](.claude/skills/specific-ai/SKILL.md)
+
+[简体中文](README.md) · [English](README.en.md) · [繁體中文](README.zh-TW.md) · [日本語](README.ja.md) · **한국어**
+
+[빠른 시작](docs/guide/quick-start.md) · [기능 매트릭스](docs/capabilities.md) · [플랫폼별 안내](docs/platforms/README.md) · [예제](docs/examples/README.md) · [에이전트용](.claude/skills/specific-ai/SKILL.md)
+
+</div>
+
+<br>
+
+> 플랫폼마다 API도, 서명 방식도, 로그인 방법도, 데이터 형식도 제각각입니다. **Specific AI는 이 모두를 하나의 인터페이스로 통합합니다**. 같은 명령어, 같은 JSON, 같은 로그인 정보 디렉터리. 플랫폼을 바꿀 때는 단어 하나만 바꾸면 됩니다.
+
+
+## ✨ Specific AI란?
+
+Specific AI는 중국과 해외의 주요 플랫폼 10곳의 web 엔드포인트 기능을 **통일된 문법**으로 호출하는 커맨드라인 도구입니다. 검색, 상세 정보, 댓글, 사용자, 추천 피드, 다운로드, 게시, DM, 라이브 방송 탄막……
+
+```bash
+specific-ai xhs      item search 露营 --sort latest
+specific-ai douyin   item search 露营 --sort latest
+specific-ai bilibili item search 露营 --sort latest
+specific-ai x        item search camping --sort latest
+```
+
+플랫폼 4곳, 거의 똑같은 명령어 4줄, 그리고 **같은 구조**의 JSON 출력. 노트, 작품, 동영상, 트윗 모두 `item`이고, 검색은 언제나 `search`, 좋아요는 언제나 `like`입니다. 한 번 배우면 10개 플랫폼 모두에서 쓸 수 있습니다.
+
+<p align="center">
+  <img src="assets/platforms.svg" width="100%" alt="지원하는 10개 플랫폼과 개발 중인 10개 플랫폼">
+</p>
+
+## 🚀 왜 Specific AI인가
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🧭 같은 의미, 같은 이름
+의미가 같은 기능은 모든 플랫폼에서 **같은 명령어, 같은 파라미터, 같은 출력**을 씁니다. 플랫폼 고유의 용어(`note`, `aweme`, `tweet`……)를 써도 괜찮습니다. 어떤 단어를 써야 하는지 Specific AI가 알려 줍니다.
+
+</td>
+<td width="50%" valign="top">
+
+### 📦 Node만 있으면 됩니다
+Python도, 컴파일러도, 어떤 시스템 의존성도 필요 없습니다. 네이티브 의존성은 모두 사전 빌드된 바이너리를 제공하며 Windows, macOS, Linux의 x64 / arm64(musl 포함)를 지원합니다. **8개 대상 시스템** 모두 CI에서 하나하나 스모크 테스트를 거칩니다.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🤖 AI 에이전트를 위한 설계
+stdout에는 JSON만 나오고, 종료 코드는 안정적이며, 오류에는 다음에 실행할 명령어가 함께 담깁니다. `specific-ai platforms`는 전체 기능 목록을 출력합니다. [에이전트 스킬](.claude/skills/specific-ai/SKILL.md)과 [llms.txt](llms.txt)를 기본 제공합니다.
+
+</td>
+<td valign="top">
+
+### 🔐 로그인 정보는 내 컴퓨터에만
+QR 코드, SMS, cookie 가져오기를 모두 지원합니다. 인증 정보는 **플랫폼 × 엔드포인트 × 계정** 단위로 `~/.specific-ai/`(0700 / 0600)에 분리 저장되며, 여러 계정을 언제든 전환할 수 있습니다. 어떤 데이터도 수집하거나 업로드하지 않고, 텔레메트리도 없습니다.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🧪 업스트림과 바이트 단위로 일치
+모든 요청의 URL, 헤더 순서, cookie, body, 서명을 난수와 시계를 고정한 상태에서 업스트림 구현과 **바이트 단위로 대조**합니다. 560+건의 골든 데이터와 940+개의 오프라인 테스트가 모든 변경을 지킵니다.
+
+</td>
+<td valign="top">
+
+### 🛡️ 브라우저급 네트워크 스택
+실제 Chrome과 동일한 TLS / HTTP2 핑거프린트. 업스트림의 서명 JS는 수정 없이 그대로 샌드박스에서 실행되고, 슬라이더·클릭 선택형 캡차는 로컬 ONNX와 OpenCV로 자동 인식합니다.
+
+</td>
+</tr>
+</table>
+
+## 📊 숫자로 보는 Specific AI
+
+<div align="center">
+
+| 🚌 플랫폼 | ⌨️ 구현된 명령어 | 🧪 골든 데이터 | ✅ 오프라인 테스트 | 💻 대상 시스템 |
+|:---:|:---:|:---:|:---:|:---:|
+| **10** | **300+** | **560+** | **940+** | **8** |
+
+</div>
+
+## 🏗️ 아키텍처
+
+<p align="center">
+  <img src="assets/architecture.svg" width="100%" alt="specific-ai 아키텍처">
+</p>
+
+- **하나의 레지스트리가 모든 것을 움직입니다**: 명령어 파싱, 4단계 `--help`, `specific-ai platforms`, [기능 매트릭스](docs/capabilities.md)가 모두 같은 레지스트리에서 생성되므로 서로 어긋날 일이 없습니다.
+- **플랫폼 하나에 파일 한 세트**: `client`는 세션과 서명을 맡고, `api`는 업스트림 메서드와 일대일로 대응하며, `normalize`는 원본 데이터를 통일된 타입으로 바꾸고, `resolve`는 ID, 링크, 공유용 단축 링크, `me`를 모두 인자로 쓸 수 있게 합니다.
+- **확장 가능**: 명세에 app / pc 엔드포인트 자리가 마련되어 있으며, JS가 아닌 업스트림은 provider 프로토콜로 연결될 예정입니다.
+
+## 🤖 AI 에이전트를 위한 설계
+
+Specific AI는 첫날부터 '프로그램이 호출하는 도구'로 설계되었습니다.
+
+```bash
+specific-ai platforms douyin | jq '.data.commands[] | select(.status=="implemented") | .resource + " " + .action'
+```
+
+- **자기 기술적**: 플랫폼별, 명령어별 로그인 요구 사항, 구현 상태, 업스트림 지원 수준을 명령어 하나로 확인할 수 있습니다.
+- **예측 가능**: 성공과 실패 모두 같은 엔벨로프 `{ ok, data, page, error }`를 쓰며, `error.hint`가 다음에 실행할 명령어를 바로 알려 줍니다.
+- **연결 가능**: 모든 출력 객체에 `id`와 `url`이 들어 있어, 앞 명령어의 결과를 그대로 다음 명령어에 넘길 수 있습니다.
+- **절제**: 위험한 작업에는 반드시 명시적인 `-y`가 필요하고, 게시물은 나만 보기로 올릴 수 있으며, 리스크 컨트롤에 걸리면 `RISK_CONTROL`로 분명히 알리고 몰래 재시도하지 않습니다.
+
+명령어 하나로 specific-ai 스킬을 Claude Code, Cursor, Codex 등 에이전트에 설치할 수 있습니다:
+
+```bash
+npx skills add Dearli666/specific-ai
+```
+
+스킬은 필요한 만큼만 불러옵니다. 개요는 한 페이지뿐이고, 다루는 플랫폼과 작업 종류(수집, 게시, 라이브·DM, 문제 해결)에 따라 [하위 파일](.claude/skills/specific-ai/SKILL.md)만 읽습니다. 안전 규칙도 내장되어 있습니다: 로그인은 사용자에게 맡기고, 쓰기 작업은 먼저 확인하며, 게시는 기본적으로 비공개, 리스크 컨트롤을 만나면 멈춥니다.
+
+## ⚡ 30초 만에 탑승
+
+```bash
+npm i -g specific-ai-cli
+
+specific-ai doctor                 # 환경 점검
+specific-ai bilibili auth login    # QR 코드로 로그인
+specific-ai bilibili item search 猫 --limit 20
+```
+
+[Docker](docs/guide/docker.md)나 소스에서 설치할 수도 있습니다. 전체 절차는 [빠른 시작](docs/guide/quick-start.md)을 참고하세요.
+
+## 📚 문서
+
+아래 문서는 중국어(간체)로 작성되어 있습니다.
+
+| | |
+|---|---|
+| 🚀 [빠른 시작](docs/guide/quick-start.md) | 설치부터 첫 데이터 내보내기까지 |
+| 🔑 [로그인](docs/guide/login.md) · ⚙️ [설정](docs/guide/configuration.md) · 🐳 [Docker](docs/guide/docker.md) | QR 코드 / cookie, 다중 계정, 프록시, 컨테이너 |
+| 📤 [출력과 오류 처리](docs/guide/output.md) | 엔벨로프, 정규화 타입, 페이지네이션, 종료 코드 |
+| 🧭 [플랫폼별 안내](docs/platforms/README.md) · 🗂️ [기능 매트릭스](docs/capabilities.md) | 플랫폼마다 무엇을 지원하는지, 인자는 어떻게 넘기는지 |
+| 🧪 [예제 스크립트](docs/examples/README.md) | 크로스 플랫폼 검색, 댓글 내보내기, 게시물 백업, 라이브 탄막 기록 |
+| 📐 [AGENTS.md](AGENTS.md) | specific-ai 명세 그 자체 |
+| ❓ [자주 묻는 질문](docs/guide/faq.md) | 왜 로그인해야 하나요? 리스크 컨트롤에 걸리면 어떻게 하나요?…… |
+
+## 🤝 기여하기
+
+issue와 PR 모두 환영합니다. 새 플랫폼, 새 명령어, 플랫폼 API 변경 대응, 문서 개선 등 무엇이든 좋습니다. 시작하기 전에 [CONTRIBUTING.md](.github/CONTRIBUTING.md)와 [AGENTS.md](AGENTS.md)를 읽어 주세요(명세가 먼저이며, 요청에는 반드시 골든 테스트가 있어야 합니다). 보안 문제는 [SECURITY.md](.github/SECURITY.md)에 따라 비공개로 제보해 주세요.
+
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 [cv-cat](https://github.com/cv-cat)
+
+<div align="center">
+<br>
+<img src="assets/logo.svg" width="64" alt="specific-ai">
+<br>
+<sub>하나의 명령으로 모든 플랫폼을 연결 · One command. Every platform.</sub>
+</div>