Top AI Repos — open-source AI, indexed and scored

Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.

epiral/weixin-bot

WeChat iLink Bot SDK for Node.js and Python — zero-config agent integration

29No licencePython

View on GitHub

Stars: 484
Forks: 54
Watchers: 2
Open issues: 7
Contributors: 1

Star history, last 90 days+18 over 27 snapshots

2026-07-31 · 4662026-11-04 · 484

Star history, last 90 days
Date	Stars
2026-07-31	466
2026-08-11	466
2026-08-18	467
2026-08-19	466
2026-08-20	467
2026-08-21	468
2026-08-27	469
2026-09-03	470
2026-09-06	471
2026-09-09	472
2026-09-10	474
2026-09-11	475
2026-09-18	474
2026-09-23	475
2026-09-25	476
2026-09-27	476
2026-09-29	477
2026-10-07	478
2026-10-13	477
2026-10-22	478
2026-10-23	479
2026-10-25	480
2026-10-26	481
2026-10-28	483
2026-10-29	484
2026-10-31	483
2026-11-04	484

Today

+1 stars today

This week

+1 stars this week

This month

+7 stars this month

Momentum

0.0

growth rate 0.21%/day

From the README

# weixin-bot

微信 iLink Bot SDK — 让任何 Agent 5 分钟接入微信消息。

## 特性

- 扫码登录，凭证自动保存
- 长轮询收消息，HTTP 发消息
- context_token 自动管理，开发者无需关心
- Typing 状态（"对方正在输入中"）
- Session 过期自动重登录
- 零配置，零 Webhook，纯本地运行

## 快速开始

### Node.js

```bash
npm install @pinixai/weixin-bot
```

```typescript
import { WeixinBot } from '@pinixai/weixin-bot'

const bot = new WeixinBot()
await bot.login()

bot.onMessage(async (msg) => {
  await bot.sendTyping(msg.userId)
  await bot.reply(msg, `Echo: ${msg.text}`)
})

await bot.run()
```

### Python

```bash
pip install weixin-bot-sdk
```

```python
from weixin_bot import WeixinBot

bot = WeixinBot()
bot.login()

@bot.on_message
async def handle(msg):
    await bot.send_typing(msg.user_id)
    await bot.reply(msg, f"Echo: {msg.text}")

bot.run()
```

## 工作原理

```mermaid
sequenceDiagram
    participant Agent as 你的 Agent
    participant SDK as weixin-bot SDK
    participant API as iLink Bot API
    participant User as 微信用户

    Note over Agent,User: 1. 登录

    Agent->>SDK: bot.login()
    SDK->>API: GET /get_bot_qrcode?bot_type=3
    API-->>SDK: 二维码 URL
    SDK-->>Agent: 终端显示二维码
    User->>API: 微信扫码确认
    API-->>SDK: bot_token + baseurl
    SDK-->>Agent: 登录成功，凭证已保存

    Note over Agent,User: 2. 收发消息循环

    Agent->>SDK: bot.run()

    loop 长轮询
        SDK->>API: POST /getupdates (hold ≤35s)
        User->>API: 发消息 "你好"
        API-->>SDK: 消息 + context_token
        SDK-->>Agent: onMessage(msg)
        Agent->>SDK: bot.sendTyping(userId)
        SDK->>API: POST /sendtyping
        Note over User: 显示"对方正在输入中"
        Agent->>SDK: bot.reply(msg, "Echo: 你好")
        SDK->>API: POST /sendmessage (带 context_token)
        API-->>User: 推送回复
        SDK->>API: POST /sendtyping (取消)
    end
```

## API

| 方法 | 说明 |
|---|---|
| `login(force?)` | 扫码登录，已有凭证则自动跳过 |
| `onMessage(handler)` | 注册消息处理回调 |
| `reply(msg, text)` | 回复消息（自动取消 typing） |
| `send(userId, text)` | 主动发消息（需已有 context_token） |
| `sendTyping(userId)` | 显示"对方正在输入中" |
| `stopTyping(userId)` | 取消输入状态 |
| `run()` | 启动长轮询循环 |
| `stop()` | 停止 |

## 协议文档

完整的微信 iLink Bot API 协议分析见 [docs/protocol-spec.md](docs/protocol-spec.md)（1200+ 行，含 curl 示例和 mermaid 时序图）。

## 关键协议发现

| 发现 | 结论 |
|---|---|
| `context_token` | 回复时必须原样传回，否则消息无法投递。SDK 内部自动管理 |
| `message_state: GENERATING` | API 层面可用，但微信客户端不渲染气泡更新。不建议使用 |
| `sendtyping` | 唯一能触发"对方正在输入中"的方式 |
| Session 过期 (`errcode: -14`) | 需要重新扫码登录。SDK 自动处理 |

## 示例

- [Node.js Echo Bot](examples/nodejs/echo-bot.ts) — 完整示例，含日志和 typing
- [Node.js 流式测试](examples/nodejs/stream-test.ts) — GENERATING vs FINISH 测试
- [Node.js Typing 测试](examples/nodejs/generating-test.ts) — sendtyping vs GENERATING 对比

## 包

| 包 | 安装 | 状态 |
|---|---|---|
| [@pinixai/weixin-bot](nodejs/) | `npm install @pinixai/weixin-bot` | [![npm](https://img.shields.io/npm/v/@pinixai/weixin-bot)](https://www.npmjs.com/package/@pinixai/weixin-bot) |
| [weixin-bot-sdk](python/) | `pip install weixin-bot-sdk` | [![PyPI](https://img.shields.io/pypi/v/weixin-bot-sdk)](https://pypi.org/project/weixin-bot-sdk/) |

## License

MIT

Excerpt of 3,022 characters

Read on GitHub

Top contributors

No contributor data yet — it is fetched during the contributor sync pass.

Quality score

Would you bet a product on this? Bounded 0–100 and slow moving.

29/10029

Maintenance: 20%; How recently the default branch was pushed to
Releases: 25%; Recency and cadence of tagged releases
Community: 5%; Contributor breadth and bus factor
Issue backlog: 85%; Open issues measured against the size of the audience
Documentation: 55%; README depth, plus a homepage and topics
Licensing: 0%; How freely the code can be adopted

What to know before adopting

No commits in 6+ months
No tagged releases
No license — all rights reserved by default, not safe to reuse
No licence file — default copyright applies, all rights reserved.

Details

Created: 8 months ago
Last push: 8 months ago
Last release: none
Release tag: —
Releases in the last year: 0
Default branch: main
Size: 178 KB
Owner type: Organization
Owner location: —
Discovered via: phrase:agentic
First indexed: 3 months ago
Last synced: 3 days ago

epiral/weixin-bot

WeChat iLink Bot SDK for Node.js and Python — zero-config agent integration

29No licencePython

View on GitHub

Stars: 484
Forks: 54
Watchers: 2
Open issues: 7
Contributors: 1

Star history, last 90 days+18 over 27 snapshots

2026-07-31 · 4662026-11-04 · 484

Star history, last 90 days
Date	Stars
2026-07-31	466
2026-08-11	466
2026-08-18	467
2026-08-19	466
2026-08-20	467
2026-08-21	468
2026-08-27	469
2026-09-03	470
2026-09-06	471
2026-09-09	472
2026-09-10	474
2026-09-11	475
2026-09-18	474
2026-09-23	475
2026-09-25	476
2026-09-27	476
2026-09-29	477
2026-10-07	478
2026-10-13	477
2026-10-22	478
2026-10-23	479
2026-10-25	480
2026-10-26	481
2026-10-28	483
2026-10-29	484
2026-10-31	483
2026-11-04	484

Today

+1 stars today

This week

+1 stars this week

This month

+7 stars this month

Momentum

0.0

growth rate 0.21%/day

From the README

# weixin-bot

微信 iLink Bot SDK — 让任何 Agent 5 分钟接入微信消息。

## 特性

- 扫码登录，凭证自动保存
- 长轮询收消息，HTTP 发消息
- context_token 自动管理，开发者无需关心
- Typing 状态（"对方正在输入中"）
- Session 过期自动重登录
- 零配置，零 Webhook，纯本地运行

## 快速开始

### Node.js

```bash
npm install @pinixai/weixin-bot
```

```typescript
import { WeixinBot } from '@pinixai/weixin-bot'

const bot = new WeixinBot()
await bot.login()

bot.onMessage(async (msg) => {
  await bot.sendTyping(msg.userId)
  await bot.reply(msg, `Echo: ${msg.text}`)
})

await bot.run()
```

### Python

```bash
pip install weixin-bot-sdk
```

```python
from weixin_bot import WeixinBot

bot = WeixinBot()
bot.login()

@bot.on_message
async def handle(msg):
    await bot.send_typing(msg.user_id)
    await bot.reply(msg, f"Echo: {msg.text}")

bot.run()
```

## 工作原理

```mermaid
sequenceDiagram
    participant Agent as 你的 Agent
    participant SDK as weixin-bot SDK
    participant API as iLink Bot API
    participant User as 微信用户

    Note over Agent,User: 1. 登录

    Agent->>SDK: bot.login()
    SDK->>API: GET /get_bot_qrcode?bot_type=3
    API-->>SDK: 二维码 URL
    SDK-->>Agent: 终端显示二维码
    User->>API: 微信扫码确认
    API-->>SDK: bot_token + baseurl
    SDK-->>Agent: 登录成功，凭证已保存

    Note over Agent,User: 2. 收发消息循环

    Agent->>SDK: bot.run()

    loop 长轮询
        SDK->>API: POST /getupdates (hold ≤35s)
        User->>API: 发消息 "你好"
        API-->>SDK: 消息 + context_token
        SDK-->>Agent: onMessage(msg)
        Agent->>SDK: bot.sendTyping(userId)
        SDK->>API: POST /sendtyping
        Note over User: 显示"对方正在输入中"
        Agent->>SDK: bot.reply(msg, "Echo: 你好")
        SDK->>API: POST /sendmessage (带 context_token)
        API-->>User: 推送回复
        SDK->>API: POST /sendtyping (取消)
    end
```

## API

| 方法 | 说明 |
|---|---|
| `login(force?)` | 扫码登录，已有凭证则自动跳过 |
| `onMessage(handler)` | 注册消息处理回调 |
| `reply(msg, text)` | 回复消息（自动取消 typing） |
| `send(userId, text)` | 主动发消息（需已有 context_token） |
| `sendTyping(userId)` | 显示"对方正在输入中" |
| `stopTyping(userId)` | 取消输入状态 |
| `run()` | 启动长轮询循环 |
| `stop()` | 停止 |

## 协议文档

完整的微信 iLink Bot API 协议分析见 [docs/protocol-spec.md](docs/protocol-spec.md)（1200+ 行，含 curl 示例和 mermaid 时序图）。

## 关键协议发现

| 发现 | 结论 |
|---|---|
| `context_token` | 回复时必须原样传回，否则消息无法投递。SDK 内部自动管理 |
| `message_state: GENERATING` | API 层面可用，但微信客户端不渲染气泡更新。不建议使用 |
| `sendtyping` | 唯一能触发"对方正在输入中"的方式 |
| Session 过期 (`errcode: -14`) | 需要重新扫码登录。SDK 自动处理 |

## 示例

- [Node.js Echo Bot](examples/nodejs/echo-bot.ts) — 完整示例，含日志和 typing
- [Node.js 流式测试](examples/nodejs/stream-test.ts) — GENERATING vs FINISH 测试
- [Node.js Typing 测试](examples/nodejs/generating-test.ts) — sendtyping vs GENERATING 对比

## 包

| 包 | 安装 | 状态 |
|---|---|---|
| [@pinixai/weixin-bot](nodejs/) | `npm install @pinixai/weixin-bot` | [![npm](https://img.shields.io/npm/v/@pinixai/weixin-bot)](https://www.npmjs.com/package/@pinixai/weixin-bot) |
| [weixin-bot-sdk](python/) | `pip install weixin-bot-sdk` | [![PyPI](https://img.shields.io/pypi/v/weixin-bot-sdk)](https://pypi.org/project/weixin-bot-sdk/) |

## License

MIT

Excerpt of 3,022 characters

Read on GitHub

Top contributors

No contributor data yet — it is fetched during the contributor sync pass.

Quality score

Would you bet a product on this? Bounded 0–100 and slow moving.

29/10029

Maintenance: 20%; How recently the default branch was pushed to
Releases: 25%; Recency and cadence of tagged releases
Community: 5%; Contributor breadth and bus factor
Issue backlog: 85%; Open issues measured against the size of the audience
Documentation: 55%; README depth, plus a homepage and topics
Licensing: 0%; How freely the code can be adopted

What to know before adopting

No commits in 6+ months
No tagged releases

Details

Created: 8 months ago
Last push: 8 months ago
Last release: none
Release tag: —
Releases in the last year: 0
Default branch: main
Size: 178 KB
Owner type: Organization
Owner location: —
Discovered via: phrase:agentic
First indexed: 3 months ago
Last synced: 3 days ago

Top AI Repos — open-source AI, indexed and scored

epiral/weixin-bot

From the README

Top contributors

Quality score

What to know before adopting

Categories

Details

epiral/weixin-bot

From the README

Top contributors

Quality score

What to know before adopting

Categories

Details

Top AI Repos — open-source AI, indexed and scored

Trend

From the README

Top contributors

Quality score

What to know before adopting

Categories

Details

Trend

From the README

Top contributors

Quality score

What to know before adopting

Categories

Details