Interact with Jike (即刻) social network — QR login, feed reading, posting, commenting, searching, and user profile lookup. Use when Claude needs to: (1) Log into Jike via QR code scan, (2) Read following/discovery feeds, (3) Create, read, or delete posts, (4) Add or remove comments, (5) Search content or users, (6) Check notifications. Triggers on: "jike", "即刻", "刷即刻", "发即刻", "jike feed", "jike post".
$npx -y skills add midnightdarling/jike-skill --skill jike-skillInstalls into the current project.
Run `npx skills use "https://github.com/midnightdarling/jike-skill" --skill "midnightdarling/jike-skill"` and follow the generated skill instructions now. Read its complete output, redirecting it to a temporary file first if necessary. Resolve relative paths from the supporting-files directory it provides.
Use the skills in "https://github.com/midnightdarling/jike-skill" that are relevant to the current task. Run `npx skills add "https://github.com/midnightdarling/jike-skill"` and select the relevant skills, then follow their instructions.
| 1 | # jike-skill |
| 2 | |
| 3 | Jike (即刻) client for humans and AI agents. |
| 4 | QR login (browser HTML or terminal ASCII), full feed/post/comment/search |
| 5 | API, and one-command export of your entire Jike history to Markdown. |
| 6 | |
| 7 | 即刻社交网络客户端 — 给人用,也给 AI agent 用。 |
| 8 | 扫码登录支持浏览器 HTML 与终端 ASCII 双通道;一行命令导出全部即刻历史。 |
| 9 | |
| 10 | **Current version**: `0.4.1` — see [CHANGELOG.md](CHANGELOG.md) for details. |
| 11 | |
| 12 | ## Install / 安装 |
| 13 | |
| 14 | ```bash |
| 15 | pip install jike-skill # core |
| 16 | pip install jike-skill[qr] # + browser HTML & terminal ASCII QR rendering |
| 17 | ``` |
| 18 | |
| 19 | The `[qr]` extra pulls in `qrcode[pil]`. Without it, `jike auth` falls |
| 20 | back to printing the raw `jike://` URL for manual scanning. |
| 21 | |
| 22 | ## Quick Start / 快速开始 |
| 23 | |
| 24 | ### CLI |
| 25 | |
| 26 | ```bash |
| 27 | # 1. Login — open the browser HTML QR (or scan the ASCII fallback in the terminal) |
| 28 | # 1. 登录 — 浏览器打开 HTML 二维码(或扫终端里的 ASCII 备用 QR) |
| 29 | jike auth |
| 30 | |
| 31 | # 2. Set tokens as env vars (recommended) / 推荐用环境变量传 token |
| 32 | export JIKE_ACCESS_TOKEN="YOUR_ACCESS_TOKEN" |
| 33 | export JIKE_REFRESH_TOKEN="YOUR_REFRESH_TOKEN" |
| 34 | |
| 35 | # 3. Browse your feed / 刷关注流 |
| 36 | jike feed |
| 37 | |
| 38 | # 4. Search / 搜索 |
| 39 | jike search --keyword "AI" |
| 40 | |
| 41 | # 5. Post something / 发一条即刻 |
| 42 | jike post --content "Hello world" |
| 43 | ``` |
| 44 | |
| 45 | ### Python |
| 46 | |
| 47 | ```python |
| 48 | from jike import JikeClient, TokenPair, authenticate |
| 49 | |
| 50 | # First time: QR login |
| 51 | tokens = authenticate() |
| 52 | |
| 53 | # Then use the client |
| 54 | client = JikeClient(tokens) |
| 55 | feed = client.feed(limit=20) |
| 56 | client.create_post(content="Hello from Python") |
| 57 | results = client.search(keyword="AI") |
| 58 | profile = client.profile(username="someone") |
| 59 | ``` |
| 60 | |
| 61 | ### Codex Plugin |
| 62 | |
| 63 | Codex does not automatically use a public repository just because it contains a |
| 64 | `SKILL.md`. Add this repository as a plugin marketplace, restart Codex, then |
| 65 | install or enable the plugin from `/plugins`. |
| 66 | |
| 67 | ```bash |
| 68 | # One-time setup: add this public repository as a Codex plugin marketplace |
| 69 | codex plugin marketplace add MidnightDarling/jike-skill |
| 70 | ``` |
| 71 | |
| 72 | After restarting Codex: |
| 73 | |
| 74 | ```text |
| 75 | /plugins |
| 76 | ``` |
| 77 | |
| 78 | Choose **Jike Skill Codex Plugins** and confirm that **Jike** is installed and |
| 79 | enabled. Codex then loads the packaged skill from `skills/jike/SKILL.md`. |
| 80 | |
| 81 | ### Claude Code Plugin |
| 82 | |
| 83 | ```bash |
| 84 | # Option A: Plugin marketplace (one-time setup) |
| 85 | /plugin marketplace add MidnightDarling/jike-skill |
| 86 | /plugin install jike@jike-skill |
| 87 | |
| 88 | # Option B: Manual copy (clone and place the whole repo as a skill folder) |
| 89 | git clone https://github.com/MidnightDarling/jike-skill.git ~/.claude/skills/jike |
| 90 | |
| 91 | # Option C: Quick use (no install, just read) |
| 92 | # Send this to any Claude Code session: |
| 93 | Read https://github.com/MidnightDarling/jike-skill/blob/main/SKILL.md |
| 94 | ``` |
| 95 | |
| 96 | Codex 需要先把公开仓库加为 plugin marketplace,再在 `/plugins` 里安装或启用; |
| 97 | Claude Code 则可以用插件一键装、手动复制文件夹到 `~/.claude/skills/`、或直接发 |
| 98 | 链接临时用。 |
| 99 | |
| 100 | ## All Commands / 全部命令 |
| 101 | |
| 102 | | Command | What it does | 功能 | |
| 103 | |---------|-------------|------| |
| 104 | | `jike auth` | QR login, print tokens | 扫码登录 | |
| 105 | | `jike feed` | Following feed | 关注流 | |
| 106 | | `jike post` | Create a post | 发帖 | |
| 107 | | `jike delete-post` | Delete a post | 删帖 | |
| 108 | | `jike comment` | Comment on a post | 评论 | |
| 109 | | `jike delete-comment` | Delete a comment | 删评论 | |
| 110 | | `jike search` | Search content | 搜索 | |
| 111 | | `jike profile` | User profile | 用户资料 | |
| 112 | | `jike user-posts` | List a user's posts | 用户帖子列表 | |
| 113 | | `jike notifications` | Check notifications | 查看通知 | |
| 114 | |
| 115 | ## Export All Posts / 导出全部帖子 |
| 116 | |
| 117 | ```bash |
| 118 | # Export to Markdown (with image URLs inline) |
| 119 | # 导出为 Markdown(图片以 URL 内联) |
| 120 | python3 scripts/export.py --username YOUR_USERNAME |
| 121 | |
| 122 | # Export with local images + raw JSON backup |
| 123 | # 导出并下载图片 + JSON 原始数据备份 |
| 124 | python3 scripts/export.py --username YOUR_USERNAME \ |
| 125 | --output my_posts.md --download-images --json-dump |
| 126 | ``` |
| 127 | |
| 128 | Both commands use `JIKE_ACCESS_TOKEN` and `JIKE_REFRESH_TOKEN` if flags are omitted. |
| 129 | |
| 130 | Features / 功能: |
| 131 | - Paginates through ALL posts automatically / 自动翻页获取全部帖子 |
| 132 | - Includes images (URLs or downloaded) / 包含图片 |
| 133 | - Preserves reposts with original author / 保留转发内容和原作者 |
| 134 | - Chronological order / 按时间排序 |
| 135 | - Topic tags and links / 包含话题标签和链接 |
| 136 | |
| 137 | ## How Auth Works / 认证原理 |
| 138 | |
| 139 | No passwords. Jike uses QR-code scan authentication (same as their web client): |
| 140 | |
| 141 | 不用密码。即刻用的是 QR 扫码认证(和它的网页版一样): |
| 142 | |
| 143 | 1. Create a session on Jike's server → get a `uuid` |
| 144 | 2. Encode the uuid into a `jike://` deep-link QR code |
| 145 | 3. User scans QR with Jike app → app confirms the session |
| 146 | 4. Server returns `access_token` + `refresh_token` |
| 147 | 5. `refresh_token` has long validity — save it, skip QR next time |
| 148 | |
| 149 | ### QR rendering (v0.4.0+) |
| 150 | |
| 151 | When `qrcode[pil]` is installed, the QR is rendered through **two |
| 152 | independent channels** — either may individually fail without breaking |
| 153 | the other: |
| 154 | |
| 155 | - **Browser HTML** — a self-contained HTML page (PNG embedded as |
| 156 | base64) is written to an unpredictable tempfile path with `0o600` |
| 157 | permissions on POSIX, and its `file://` URI is printed to stderr. |
| 158 | The file is removed automatically when the auth flow returns. |
| 159 | - **Terminal ASCII** — the same QR is also printed to stderr for |
| 160 | terminals that can render it. |
| 161 | |
| 162 | If `qrcode` is not installed, the raw `jike://` URL is printed instead |
| 163 | so it can be scanned out-of-band. |
| 164 | |
| 165 | 二选一,互不影响:装了 `qrcode` 就同时给浏览器 HTML 与终端 ASCII; |
| 166 | 没装就直接打印 `jike://` 原始链接,手动扫描。 |
| 167 | |
| 168 | ## Architecture / 项目结构 |