> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 公众号链接里的 mid、idx、sn 是什么？短链接必须转成长链吗？

> 保留完整文章链接，区分群发与单篇身份，离线审计公开长短链，不编造短链转换或校验值。

公众号长链接里的 `__biz` 对应账号，`mid` 对应一次群发，`idx` 是文章在这次群发里的位置，`sn` 是链接携带的校验参数。查正文或互动时，直接传收到的完整链接，不要改参数；公开短链接也能直接用。整理链接清单时一定保留 `idx`：`__biz` + `mid` + `idx` 一起才确定一篇文章。

## `__biz`、`mid`、`idx`、`sn` 什么时候会用到？

| 参数      | 整理文章时的作用                       |
| ------- | ------------------------------ |
| `__biz` | 长链接中的账号成分；查账号历史时仍使用 `username` |
| `mid`   | 区分消息/群发，原样保存                   |
| `idx`   | 区分同次群发中的文章，从1开始                |
| `sn`    | 随原链接一起保存，取文时直接传完整URL           |

最容易弄丢的是 `idx`。例如同一个 `__biz`、同一个 `mid`，一条链接是 `idx=1`，另一条是 `idx=2`，两条链接是同一次群发里的两篇不同文章。做资料表时两条都留下，不能只按公众号或 `mid` 去重。

不要把 `mid` 手工改成别的接口字段名。读文章时传完整 `url`；查账号历史时，从文章详情取得 `user_name`。

## 同事发来一批链接，怎么整理？

先保留收到的原始清单，再按链接形式分别处理：

| 拿到的链接                      | 怎么做                   |
| -------------------------- | --------------------- |
| `/s/…` 短链接                 | 直接用于取文或统计，保留原样        |
| 带 `__biz`、`mid`、`idx` 的长链接 | 保留完整参数，按文章身份归类        |
| 三个身份参数相同、附加参数不同            | 放进同一候选组，核对差别后选择要用的原链接 |
| `idx` 不同                   | 分成不同文章                |
| 链接被截断、复制成了HTML文本           | 向提供者补要完整公开分享链接，不自行猜参数 |

短链和长链看起来像同一篇时，先各自保留，等拿到可核对的文章信息再关联。标题相同可以作为线索，不能单凭标题删掉其中一条。

收到带额外来源参数的链接时，先按 `__biz`、`mid` 和 `idx` 放进同一候选组，保留每条原 URL。读取文章后，用返回的标题和来源核对分组。

## 大批量时，用本地清单先整理

下面的 `audit_links.py` 一次检查 1–200 条链接，不访问文章，成功后生成两个文件：

* `input-urls.json`：原始输入，方便回查。
* `link-audit.json`：长短链、长链身份参数、同身份候选组。

`same_long_identity_groups` 里的 `input_indices` 是输入 JSON 数组中从 0 开始的位置。每条原 URL 都保留；短链的身份保持未解析，需要时再读取文章核对。`link-audit.json` 只说明链接结构，文章能否读取以实际读取结果为准。

准备好清单后，选需要的文章进入[正文读取](/zh/guides/read-wechat-article)或[互动统计](/zh/faq/wechat-article-metrics)。想继续看账号历史，则走[文章到账号定位](/zh/faq/wechat-account-identifier)。调用计费见[价格页](https://beatapi.io/zh/pricing)。

## 附：离线整理脚本

把实际链接保存为 `article-links.json` 里的 JSON 数组，格式如下：

```json
[
  "https://mp.weixin.qq.com/s?__biz=EXAMPLE_ACCOUNT&mid=123456789&idx=2&sn=EXAMPLE_CHECK_VALUE",
  "https://mp.weixin.qq.com/s/example-short-token"
]
```

把后面的脚本保存为 `audit_links.py`，然后运行：

```bash
python3 audit_links.py article-links.json link-review
```

`audit_links.py` 检查公开分享链接的结构，保留输入字节和原 URL；遇到复制错误或不明确的身份参数时，`audit_links.py` 停止并提示需要核对的条目。每次运行用新的输出目录名，已有结果会保留。

```python
import hashlib,json,pathlib,re,sys
from urllib.parse import parse_qs,urlsplit
source,target=map(pathlib.Path,sys.argv[1:]);original=source.read_bytes();urls=json.loads(original)
if not isinstance(urls,list) or not 1<=len(urls)<=200:raise ValueError('Provide 1..200 public article URLs')
rows=[];groups={}
for url in urls:
    if not isinstance(url,str) or not url or any(c.isspace() or ord(c)<32 or ord(c)==127 for c in url):raise ValueError('Use an intact public URL without whitespace/control characters')
    parsed=urlsplit(url)
    if parsed.scheme not in ('http','https') or parsed.hostname!='mp.weixin.qq.com' or parsed.username is not None or parsed.password is not None or parsed.port not in (None,80,443):raise ValueError('Expected a WeChat article host without embedded credentials')
    query=parse_qs(parsed.query,keep_blank_values=True)
    if any(k.startswith('amp;') for k in query):raise ValueError('Copy the actual URL, not HTML-escaped markup')
    if any(k.lower() in ('pass_ticket','key','uin','ticket','access_token') for k in query):raise ValueError('Use a public share URL without browser-session parameters')
    for key in ['__biz','mid','idx','sn']:
        if key in query and (len(query[key])!=1 or not query[key][0] or any(c.isspace() or ord(c)<32 or ord(c)==127 for c in query[key][0])):raise ValueError('Ambiguous, blank or malformed article component: '+key)
    if parsed.path=='/s':
        if not all(k in query for k in ['__biz','mid','idx']):raise ValueError('Long-link identity needs __biz, mid and idx')
        biz,mid,idx=(query[k][0] for k in ['__biz','mid','idx'])
        if not re.fullmatch(r'[0-9]+',mid) or int(mid)<1 or not re.fullmatch(r'[0-9]+',idx) or int(idx)<1:raise ValueError('mid/idx must be original positive ASCII digit strings')
        identity=[biz,mid,idx]
        row={'url':url,'kind':'long','biz':biz,'mid':mid,'idx':idx,'sn_present':'sn' in query,'identity':identity,
             'position':'headline' if int(idx)==1 else 'secondary'}
        groups.setdefault(json.dumps(identity,ensure_ascii=False),[]).append(len(rows))
    elif parsed.path.startswith('/s/') and parsed.path[3:] and '/' not in parsed.path[3:]:
        row={'url':url,'kind':'short','biz':None,'mid':None,'idx':None,'sn_present':'sn' in query,'identity':None,'position':'not_derived_from_short_link'}
    else:raise ValueError('Expected /s with long parameters or one /s/ article token')
    rows.append(row)
target.mkdir()
(target/'input-urls.json').write_bytes(original)
(target/'link-audit.json').write_text(json.dumps({'links':rows,
    'same_long_identity_groups':[{'identity':json.loads(k),'input_indices':v} for k,v in groups.items() if len(v)>1],
    'input_sha256':hashlib.sha256(original).hexdigest(),'short_long_aliases_resolved':False,
    'network_requests':0,'article_availability_verified':False},ensure_ascii=False,indent=2),encoding='utf-8')
print(json.dumps({'links':len(rows),'long_links':sum(r['kind']=='long' for r in rows),'short_links':sum(r['kind']=='short' for r in rows),'network_requests':0}))
```