微信搜一搜公开数据 API | SandBase

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

深色电影质感画面:微信搜一搜结果与视频数据经由同一条 API 管道汇入 Agent 内核

关键词搜索与文章详情回答的是两个问题。搜索帮你发现候选链接;文章详情从一条已经选定的完整链接开始。如果自动打开第一条搜索结果,还没核对相关性和返回数据,一个简单的发现任务就变成了更多读取与分析。

本次 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 0items 数组
检查已选文章的响应公众号文章详情完整 url、raw falsecontent 对象和 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 也不是简单换个显示样式,不能假设还可以用相同业务路径解析。

SandBase 微信搜一搜 API 页面:描述、能力标签与端点列表 历史微信搜索目录截图。图中的搜索/视频导航没有覆盖本轮另选的公众号文章端点;旧数量和目录 GET 标签不是最新可用性或执行方式检查。

复用配置,拿到一次响应就停

已有 SandBase Key,就放在运行环境或密钥管理器。已连接 Agent 应复用配置,只选文章发现或已知链接检查,不悄悄把两者都调用,也不下载所有缩略图或启动摘要链。所选公开读取不要求你的微信登录,这不代表获得账号权限或私聊访问。

新项目可把 SKILL.md、quickstart.md 和快速开始交给 Agent,再说明:“搜索一次 OpenAI 相关文章,展示返回字段,缺失保持未知,先不要打开候选链接。”密钥不发到聊天里。看过首个结果后,再决定追加什么读取。

两种首请求共用的 Python

在 Python 环境安装 requests。helper 先校验输入,再执行一次带连接/读取超时的请求,并拒绝跳转。错误不回显上游响应正文或凭据。它不会重试、续页、下载媒体、跟随合集链接或调用模型。

Python
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 来修补。

JSON
{
  "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 结构。来源要分开说明;本轮没有运行任何一个查询,也没有把两份计数写成新测出的对比。

某个微信搜一搜端点的 SandBase API 参考,展示带厂商前缀的 URL 和响应结构 历史微信搜索参数与信封参考。当前示例明确选择文章类型及简化输出;旧空业务示例不代表缺少 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。私聊、成员动作和账号授权数据不属于本流程。

觉得有用?分享给更多人