微信搜一搜公开数据 API | SandBase
搜索一页微信文章候选,或独立检查已知文章 URL。提供 Python 接入、简化响应校验与游标说明,明确正文和历史证据边界。

关键词搜索与文章详情回答的是两个问题。搜索帮你发现候选链接;文章详情从一条已经选定的完整链接开始。如果自动打开第一条搜索结果,还没核对相关性和返回数据,一个简单的发现任务就变成了更多读取与分析。
本次 2026-11-08 修订覆盖一次微信文章搜索,或一次独立的公众号文章详情请求。依据是免费 inspect 与公开参考,没有新的业务调用。2026-09-27 UTC 的原搜索摘录在下方保留,本轮没有重新获取文章正文、续页或视频搜索结果。
先说结论
- 搜索使用
wechat-search/v2/search,明确 keyword、business_type article、raw false 和首页 offset 零。- 已知完整文章链接使用另一个 vendor 路由
wechat-mp/v2/article-detail,输入 url 和 raw false。- 只读 outputs[0].data。简化搜索有 items 数组;文章参考有 content 和 url,但截断样本没有展示正文。
- offset 单独递增会重复首页,续页需要真实返回的 cursor;本例既不续页,也不自动打开结果。
沿用封面是概念插画,卡片、计数和搜索/视频链路只是示意,不是新测量或已经执行的文章读取流程。图中的品牌、徽章及分类标签不代表已核实的账号身份、品牌背书或当前能力覆盖。
根据手头输入选择任务
| 想做什么 | 精确端点 | 输入例子 | 参考结构 |
|---|---|---|---|
| 按关键词发现文章候选 | 微信搜索 | keyword、business_type article、raw false、offset 0 | items 数组 |
| 检查已选文章的响应 | 公众号文章详情 | 完整 url、raw false | content 对象和 url |
这是同一 SandBase 鉴权下的两个 vendor 命名空间。不要给详情端点发关键词,也不要把搜索 docID 当作 url。搜索 keyword 长度为 1–100 字符;详情接受 mp.weixin.qq.com 文章链接,包括短 /s/… 路径和带 __biz 的长查询形式。长 URL 要保留完整参数,README 里被截断的地址和省略号不能拿来请求。
搜索默认 business_type 为 all、raw 为 true。新示例明确选 article 和 raw false,使 parser 对应简化参考。响应中的 business_type 数字 2,不会改变请求契约里要求的字符串 article。把 raw 改回 true 也不是简单换个显示样式,不能假设还可以用相同业务路径解析。
历史微信搜索目录截图。图中的搜索/视频导航没有覆盖本轮另选的公众号文章端点;旧数量和目录 GET 标签不是最新可用性或执行方式检查。
复用配置,拿到一次响应就停
已有 SandBase Key,就放在运行环境或密钥管理器。已连接 Agent 应复用配置,只选文章发现或已知链接检查,不悄悄把两者都调用,也不下载所有缩略图或启动摘要链。所选公开读取不要求你的微信登录,这不代表获得账号权限或私聊访问。
新项目可把 SKILL.md、quickstart.md 和快速开始交给 Agent,再说明:“搜索一次 OpenAI 相关文章,展示返回字段,缺失保持未知,先不要打开候选链接。”密钥不发到聊天里。看过首个结果后,再决定追加什么读取。
两种首请求共用的 Python
在 Python 环境安装 requests。helper 先校验输入,再执行一次带连接/读取超时的请求,并拒绝跳转。错误不回显上游响应正文或凭据。它不会重试、续页、下载媒体、跟随合集链接或调用模型。
import os
from urllib.parse import urlsplit
import requests
def first_request(task, value):
if task not in ("search", "article"):
raise ValueError("Choose search or article")
if not isinstance(value, str) or not value.strip():
raise ValueError("Supply a nonempty keyword or full article URL")
if task == "search":
if len(value) > 100:
raise ValueError("Keyword must contain 1 to 100 characters")
route = "wechat-search/v2/search"
params = {"keyword": value, "business_type": "article", "raw": False, "offset": 0}
else:
try:
parts = urlsplit(value)
valid = (
len(value) <= 2048 and not any(c.isspace() for c in value)
and "…" not in value and "..." not in value
and parts.scheme in ("http", "https")
and parts.netloc == "mp.weixin.qq.com"
and not parts.fragment
and ((parts.path.startswith("/s/") and len(parts.path) > 3)
or (parts.path == "/s" and bool(parts.query)))
)
except ValueError:
valid = False
if not valid:
raise ValueError("Supply a complete mp.weixin.qq.com article URL")
route = "wechat-mp/v2/article-detail"
params = {"url": value, "raw": False}
key = os.environ.get("SANDBASE_API_KEY", "").strip()
if not key:
raise ValueError("Set SANDBASE_API_KEY in the local environment")
try:
response = requests.post(
f"https://api.sandbase.ai/v1/api/{route}",
headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"},
json=params, timeout=(10, 90), allow_redirects=False,
)
if not 200 <= response.status_code < 300:
raise RuntimeError(f"HTTP {response.status_code}; request stopped")
body = response.json()
except ValueError:
raise RuntimeError("Response was not valid JSON") from None
except requests.RequestException:
raise RuntimeError("Network request failed or timed out") from None
if not isinstance(body, dict) or body.get("status") != "completed":
raise RuntimeError("SandBase request did not complete")
outputs = body.get("outputs")
if not isinstance(outputs, list) or not outputs or not isinstance(outputs[0], dict):
raise RuntimeError("Missing documented output")
payload = outputs[0].get("data")
if not isinstance(payload, dict):
raise RuntimeError("Missing business object")
if task == "search":
items = payload.get("items")
if not isinstance(items, list) or any(not isinstance(item, dict) for item in items):
raise RuntimeError("Missing simplified article items array")
else:
if not isinstance(payload.get("content"), dict):
raise RuntimeError("Missing reference content object")
if not isinstance(payload.get("url"), str) or not payload["url"]:
raise RuntimeError("Missing reference article URL")
# A valid content object does not prove the full article body is present.
return payload
if __name__ == "__main__":
result = first_request("search", "OpenAI")
print("Business fields:", sorted(result))独立检查文章时,把最后赋值改成 result = first_request("article", "https://mp.weixin.qq.com/s/TSNQKkRpN1qbKsT7BvzqIw"),保留 print。这是 schema 的示例 URL,不是本轮执行过的文章。不要在搜索后追加这一行,除非明确选择两次请求。本地 URL 检查拒绝不完整或明显截断的地址,但不能证明目标文章仍可用。
parser 接受空 items 数组,但拒绝字段缺失或非对象成员。文章模式要求 content 对象和返回的 URL 字符串,这只是参考结构检查,不代表正文已经存在。原业务对象直接返回,不补造标题、正文、账号或统计值。这两个参考也不能支持把别的平台 status_code 零规则搬过来。
原搜索记录能支持什么
旧文把 2026-09-27 UTC 抓取归到 b4252b59-a208-404e-a2f8-2e6a9e2e9d37,JSON 却是 677def62-bd58-48fb-bb31-ec694c49f80f。两个标识都保留。这是原记录尚未解决的归属不一致,不能当成已确认的两次运行,也不能猜一个新 ID 来修补。
{
"id": "677def62-bd58-48fb-bb31-ec694c49f80f",
"status": "completed",
"model": "wechat-search/v2/search",
"outputs": [
{
"data": {
"keyword": "人工智能",
"offset": 18,
"continue_flag": 1,
"no_more": null,
"categories": [],
"results": {}
}
}
]
}旧摘录中 categories 与 results 为空,不应继续用它们解析今天明确选择的 article/raw false 任务。当前公开参考使用 items,categories 可以为 null。只要 items 存在,categories 缺失或为空就不能直接解释为没有文章候选。
完整保存搜索样例日期为 2026-10-07T17:37:38.159Z,使用的是大学招生相关关键词,不是短 README 的 OpenAI 关键词。保存输入明确包括 business_type article、raw false、offset 0、sort default、publish_time all,响应支持简化 items 结构。来源要分开说明;本轮没有运行任何一个查询,也没有把两份计数写成新测出的对比。
历史微信搜索参数与信封参考。当前示例明确选择文章类型及简化输出;旧空业务示例不代表缺少 items 也是有效结果。
候选字段不是已经核实的文章事实
搜索公开参考展示 title、desc、doc_url、source、时间戳和 docID。标题与片段可能包含 <em class="highlight"> 命中标记,要有意识地保留或处理,不能直接当普通文本或未经检查的安全 HTML。摘要片段不是全文,其中的说法也不会因为进入搜索结果就自动得到证实。
source.title 是显示的账号名称,不等于账号身份或权威性证明。source.dateTime 可能是相对时间文本,timestamp/date 则是参考里的独立数字字段。把来源与采集时间一起保留,不能把旧样本的“51 分钟前”换算成现在的新发布日期。docID 保持返回字符串,它不是文章 URL 的替代品。
count、total 是搜索报告的值,不证明全量覆盖。README 把数组裁到一个元素,却保留页级计数,所以不能拿展示数组长度复原整页。示例保留可选值,不作排名、市场份额或“全部相关文章”保证。debug 字段不是读者任务所必需,不复制到新示例或公共日志。
详情证据还没到“正文已读取”这一步
文章详情公开 model 没有完整保存样例。短 README 展示 url、bizUin 和含元信息、配置字段的 content 对象,但截断 JSON 中看不到正文或标题。字段表描述可能的标题、作者及 HTML 位置,文档描述与可用样本里实际观察到字段是两回事。
因此,helper 检查 content 对象,却不声称已经读取全文。结构有效的对象仍可能没有索引或摘要所需的文本。下游任务必须检查实际返回字段,明确处理正文缺失;不能把空字符串交给模型,再把生成内容称为文章摘要。
参考还描述合集导航,并说明阅读量、点赞量属于其他接口。本轮不跟随上一篇/下一篇,也不请求统计。返回 HTML 和媒体 URL 是数据,不代表可以执行标记、下载资源或转载。完整选定 URL 才是详情输入,搜索结果应先检查相关性再决定独立请求。
续页不是 offset 加法
当前搜索契约要求首页不带 cursor。续页时回传上一响应 cursor,并保持关键词和筛选条件一致,尤其重复 sort、publish_time;continue_flag 表示还报告有后续页面。只用 offset 并不能翻页,而会再次拿到第一页。
新示例发送 offset 0 并省略 cursor,不递增 offset,不复制 README 中截断的游标,也不看到标志就自动继续。本轮没有测试续页。首页成功不证明去重、完整覆盖或重复搜索时顺序稳定,旧摘录里的空 categories 也不能解决这些问题。
历史视频搜索参数参考,不是端点列表截图。视频搜索不在本轮文章任务范围,参数与续页行为没有在这里重新验证。
价格与下一步
2026-11-08 免费 inspect 显示,两个所选端点均为 $0.01,符合组织内合格 API 每日共享 100 次额度,00:00 UTC 重置。资格不是剩余次数、余额或实付账单。本轮没有业务请求,也不保证免费成功。
选择一次请求标价 $0.01;独立选择搜索和文章检查才是 $0.02,尚未考虑额度。打开全部候选、续页、重试、统计和模型分析都会增加工作量。helper 会停止,让下一问题与预算单独决定。
历史代码和其他入口
原 Python 已在历史归档逐字保存并附哈希。以 categories 为主的旧示例和概括的搜索/视频链路属于历史,不是当前简化文章响应的运行指引。沿用原 canonical 页面与证据,不另造一篇近重复教程。
微信搜索目录可用于寻找另一个明确的发现任务;Telegram API 总览展示另一类公开数据接入,但统一鉴权不意味着参数和业务字段相同。SandBase 提供接入层,不拥有微信,也不因此获得账号授权操作能力。
常见问题
可以用 offset 获取下一页吗? 不可以,当前契约说明单独 offset 会重复首页。本例只读首页;后续任务要使用真实返回的 cursor 并保持筛选一致。
raw false 保证文章完整吗? 不保证,它选择简化输出。当前参考只有 content 对象,没有可见全文,本轮也未执行新的文章请求。
搜索和详情能自动串起来吗? 在更大应用中可以作为分别决定的步骤,但本例不选首条结果、不自动打开。先核相关性、完整 URL 和返回字段,再扩大任务。
需要微信登录吗? 所选公开读取使用 SandBase Key。私聊、成员动作和账号授权数据不属于本流程。
觉得有用?分享给更多人