youke 0.2.1__py3-none-any.whl

hiddenapi/__init__.py

@@ -0,0 +1,103 @@
+# -*- coding: utf-8 -*-
+"""hiddenapi —— 把"APP 里有、网页上没有"的隐藏接口，做成统一的 Python 调用层。
+
+    from hiddenapi import open_adapter
+    api = open_adapter("coolapk")
+    page = api.search("微信", type="apk")
+    for it in page.items:
+        print(it.title, it.extra.get("apkname"))
+
+设计原则：
+  1. 一个平台一个 adapter，统一 search()/detail()/suggest()
+  2. 签名算法单独放 signers/，可独立复用
+  3. 不登录就说不登录，被风控就说被风控 —— 绝不把失败伪装成"0 条结果"
+  4. 主包只装「装上就能用」的平台；有登录墙的放 experimental/，默认不加载
+"""
+from __future__ import annotations
+
+from typing import Any, List, Optional
+
+from .core import (
+    DEFAULT_UA,
+    MOBILE_UA,
+    TIER_EXPERIMENTAL,
+    TIER_STABLE,
+    AuthRequired,
+    BaseAdapter,
+    EndpointMissing,
+    HiddenApiError,
+    HttpClient,
+    HttpError,
+    Item,
+    NotSupported,
+    RequestRejected,
+    RiskControl,
+    SearchPage,
+    all_adapters,
+    get,
+    names,
+    tier_of,
+)
+
+__version__ = "0.2.1"
+
+# 触发稳定适配器自动注册（失败只 warn）
+from . import adapters  # noqa: E402,F401
+from . import experimental  # noqa: E402
+
+
+def enable_experimental(*which: str) -> List[str]:
+    """显式开启实验性平台（有登录墙 / native 签名门槛的那些）。
+
+        enable_experimental()          # 全部
+        enable_experimental("zhihu")   # 只开知乎
+
+    不调用也能用：open_adapter() 发现名字在实验区时会自动加载一次。
+    """
+    if not which:
+        return experimental.load(None)
+    out: List[str] = []
+    for w in which:
+        out.extend(experimental.load(w))
+    return out
+
+
+def open_adapter(name: str, http: Optional[HttpClient] = None, **opts: Any) -> BaseAdapter:
+    """按名字创建适配器实例。
+
+    Parameters
+    ----------
+    name : 平台名，如 "coolapk" / "bilibili" / "netease" / "weibo"
+           也可以是实验性的 "douyin" / "zhihu" / "xiaohongshu"（会自动加载）
+    http : 复用已有 HttpClient（想共享代理/限速时用）
+    cookie : 登录态 Cookie 字符串，传给需要登录的平台
+    """
+    from .core.registry import has
+
+    if not has(name):
+        # 名字可能在实验区还没被 import，试一次再失败
+        try:
+            experimental.load(name)
+        except KeyError:
+            pass
+    cls = get(name)
+    return cls(http=http, **opts)
+
+
+def search(name: str, keyword: str, page: int = 1, **opts: Any) -> SearchPage:
+    """一行搜索：search("coolapk", "微信", type="apk")"""
+    adapter_opts = {k: opts.pop(k) for k in list(opts) if k in ("cookie", "http", "proxy", "delay")}
+    return open_adapter(name, **adapter_opts).search(keyword, page=page, **opts)
+
+
+__all__ = [
+    "open_adapter", "search", "enable_experimental",
+    "BaseAdapter", "Item", "SearchPage", "HttpClient", "HttpError",
+    # 失败类型：调用方应该按这五个分别 catch，而不是笼统的 RuntimeError
+    "HiddenApiError", "AuthRequired", "RiskControl", "RequestRejected",
+    "EndpointMissing", "NotSupported",
+    "DEFAULT_UA", "MOBILE_UA",
+    "get", "names", "all_adapters", "tier_of",
+    "TIER_STABLE", "TIER_EXPERIMENTAL",
+    "__version__",
+]

hiddenapi/__main__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+from .cli import main
+
+raise SystemExit(main())

hiddenapi/adapters/__init__.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+"""稳定平台适配器：装上就能用，search() 直接出数据。
+
+import 时自动注册。某个平台的依赖缺失时只 warn，不影响其它平台可用。
+有登录墙/native 签名门槛的平台不在这里，见 hiddenapi.experimental。
+"""
+from __future__ import annotations
+
+import os
+import warnings
+
+_BUILTIN = (
+    "coolapk",
+    "bilibili",
+    "netease",
+    "weibo",
+)
+
+_loaded = []
+_failed = {}
+
+for _mod in _BUILTIN:
+    # 只对"文件在、导入却失败"的情况报警；未实现的平台静默跳过
+    _path = os.path.join(os.path.dirname(__file__), _mod + ".py")
+    if not os.path.exists(_path):
+        continue
+    try:
+        __import__("%s.%s" % (__name__, _mod), fromlist=["*"])
+        _loaded.append(_mod)
+    except Exception as _exc:  # noqa: BLE001
+        _failed[_mod] = "%s: %s" % (type(_exc).__name__, _exc)
+
+if _failed:
+    warnings.warn(
+        "hiddenapi: 以下适配器未加载（依赖缺失或平台改版）：%s" % _failed,
+        RuntimeWarning,
+        stacklevel=2,
+    )
+
+__all__ = list(_loaded)

hiddenapi/adapters/bilibili.py

@@ -0,0 +1,257 @@
+# -*- coding: utf-8 -*-
+"""B站（bilibili.com）Web 端适配器 —— WBI 签名 + buvid3 匿名指纹。
+
+算法出处 / 许可证
+----------------
+- WBI 签名（mixinKeyEncTab 重排表 + `md5(urlencode(sorted_params) + mixinKey)`）
+  出处: SocialSisterYi/bilibili-API-collect, MIT License
+        https://github.com/SocialSisterYi/bilibili-API-collect/blob/master/docs/misc/sign/wbi.md
+- buvid3 / buvid4 匿名指纹（/x/frontend/finger/spi）
+  出处: Nemo2011/bilibili-api, MIT License
+        https://github.com/Nemo2011/bilibili-api
+
+本文件只移植上述两个公开算法常量与流程，不复制其工程代码。仅依赖 requests。
+
+实测（2025-11，未登录）：
+  ✅ /x/web-interface/wbi/search/type  搜索视频，返回 bvid/title/author/play/duration
+  ✅ /x/web-interface/view            视频详情，返回 stat/pages
+  ⚠️ nav 接口未登录时 code=-101，但 data.wbi_img 仍然下发，mixinKey 照常可取
+"""
+from __future__ import annotations
+
+import hashlib
+import time
+import urllib.parse
+from typing import Any, Dict, List, Optional
+
+from ..core.base import BaseAdapter, Item, SearchPage
+from ..core.registry import register
+
+MIXIN_KEY_ENC_TAB = [
+    46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49,
+    33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13, 37, 48, 7, 16, 24, 55, 40,
+    61, 26, 17, 0, 1, 60, 51, 30, 4, 22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11,
+    36, 20, 34, 44, 52,
+]
+
+NAV = "https://api.bilibili.com/x/web-interface/nav"
+SPI = "https://api.bilibili.com/x/frontend/finger/spi"
+SEARCH = "https://api.bilibili.com/x/web-interface/wbi/search/type"
+VIEW = "https://api.bilibili.com/x/web-interface/view"
+HOME = "https://www.bilibili.com/"
+
+
+def _img_key(url: str) -> str:
+    """https://i0.hdslb.com/bfs/wbi/<32hex>.png -> <32hex>"""
+    return url.rsplit("/", 1)[-1].split(".")[0]
+
+
+def mixin_key(img_key: str, sub_key: str) -> str:
+    raw = img_key + sub_key
+    return "".join(raw[i] for i in MIXIN_KEY_ENC_TAB if i < len(raw))[:32]
+
+
+def sign_wbi(params: Dict[str, Any], mixin: str) -> Dict[str, Any]:
+    """排序 + 过滤 !'()* + urlencode，拼 mixinKey 取 md5 => w_rid。
+
+    注意：只有「参与哈希计算」的那份副本会被 str() 化 + 过滤字符；
+    返回给 requests 的 params 保留调用方传进来的原始类型（page 仍是 int），
+    这样日志/复现时看到的和实际发出的一致，也方便下游做类型判断。
+    """
+    out = dict(params)
+    out["wts"] = int(time.time())
+    out = {k: out[k] for k in sorted(out)}
+    hashed = {
+        k: "".join(ch for ch in str(v) if ch not in "!'()*")
+        for k, v in out.items()
+    }
+    query = urllib.parse.urlencode(hashed)
+    out["w_rid"] = hashlib.md5((query + mixin).encode()).hexdigest()
+    return out
+
+
+def _clean(s: Optional[str]) -> str:
+    """搜索结果标题里带 <em class="keyword"> 高亮。"""
+    if not s:
+        return ""
+    for a, b in (
+        ('<em class="keyword">', ""),
+        ("</em>", ""),
+        ("&amp;", "&"),
+        ("&quot;", '"'),
+        ("&#39;", "'"),
+        ("&lt;", "<"),
+        ("&gt;", ">"),
+    ):
+        s = s.replace(a, b)
+    return s
+
+
+def _pic(u: Optional[str]) -> str:
+    if not u:
+        return ""
+    return u if u.startswith("http") else "https:" + u
+
+
+@register
+class BilibiliAdapter(BaseAdapter):
+    name = "bilibili"
+    aliases = ("B站", "哔哩哔哩", "bilibili.com")
+    home = HOME
+    needs_login = False
+    note = "WBI 签名 + buvid3 匿名指纹；搜索/视频详情均免登录（移植 bilibili-API-collect, MIT）"
+
+    def __init__(self, http: Optional[Any] = None, cookie: str = "", **opts: Any):
+        super().__init__(http=http, cookie=cookie, **opts)
+        self.http.set_host_headers(
+            "bilibili.com",
+            {
+                "Referer": HOME,
+                "Origin": "https://www.bilibili.com",
+                "Accept": "application/json, text/plain, */*",
+            }
+        )
+        if cookie:
+            self.http.update_headers({"Cookie": cookie})
+        self._mixin: Optional[str] = None
+        self._mixin_ts: float = 0.0
+        self._init_cookies()
+
+    # ------------------------------------------------------------ 初始化
+    def _init_cookies(self) -> None:
+        """无 buvid3 时搜索接口极容易被 -352 风控，先取匿名指纹。"""
+        if self.http.cookies.get("buvid3"):
+            return
+        try:
+            js = self.http.get_json(SPI)
+            d = js.get("data") or {}
+            if d.get("b_3"):
+                self.http.set_cookie("buvid3", d["b_3"], domain=".bilibili.com")
+            if d.get("b_4"):
+                self.http.set_cookie("buvid4", d["b_4"], domain=".bilibili.com")
+        except Exception:
+            pass
+        if not self.http.cookies.get("buvid3"):
+            try:
+                self.http.get(HOME)
+            except Exception:
+                pass
+
+    def _get_mixin(self, refresh: bool = False) -> str:
+        if not refresh and self._mixin and time.time() - self._mixin_ts < 3600:
+            return self._mixin
+        js = self.http.get_json(NAV)
+        wbi = ((js.get("data") or {}).get("wbi_img")) or {}
+        if not wbi.get("img_url"):
+            raise RuntimeError("bilibili nav 未返回 wbi_img，WBI 签名不可用")
+        self._mixin = mixin_key(_img_key(wbi["img_url"]), _img_key(wbi["sub_url"]))
+        self._mixin_ts = time.time()
+        return self._mixin
+
+    def _signed_get_json(self, url: str, params: Dict[str, Any]) -> Dict[str, Any]:
+        js: Dict[str, Any] = {}
+        for attempt in (0, 1):
+            signed = sign_wbi(params, self._get_mixin(refresh=bool(attempt)))
+            js = self.http.get_json(url, params=signed)
+            if js.get("code") in (-403, -352) and attempt == 0:
+                continue
+            break
+        return js
+
+    # ------------------------------------------------------------ search
+    def search(self, keyword: str, page: int = 1, **kw: Any) -> SearchPage:
+        """搜索视频。kw 支持 page_size（默认 20）。"""
+        page_size = int(kw.get("page_size") or 20)
+        params = {
+            "search_type": "video",
+            "keyword": keyword,
+            "page": page,
+            "page_size": page_size,
+        }
+        js = self._signed_get_json(SEARCH, params)
+        if js.get("code") != 0:
+            raise RuntimeError(
+                "bilibili search failed: code=%s message=%s"
+                % (js.get("code"), js.get("message"))
+            )
+        data = js.get("data") or {}
+        raw_items = data.get("result") or []
+        items: List[Item] = []
+        for it in raw_items:
+            if it.get("type") and it.get("type") != "video":
+                continue
+            bvid = it.get("bvid") or ""
+            items.append(
+                Item(
+                    title=_clean(it.get("title")),
+                    subtitle="%s · %s 播放 · %s" % (
+                        it.get("author") or "",
+                        it.get("play") or 0,
+                        it.get("duration") or "",
+                    ),
+                    url="https://www.bilibili.com/video/%s" % bvid if bvid else (it.get("arcurl") or ""),
+                    image=_pic(it.get("pic")),
+                    author=it.get("author") or "",
+                    extra={
+                        "bvid": bvid,
+                        "aid": it.get("aid"),
+                        "play": it.get("play"),
+                        "danmaku": it.get("video_review"),
+                        "favorites": it.get("favorites"),
+                        "duration": it.get("duration"),
+                        "pubdate": it.get("pubdate"),
+                        "mid": it.get("mid"),
+                    },
+                    raw=it,
+                )
+            )
+        total = data.get("numResults") or data.get("total") or data.get("numPages")
+        num_pages = data.get("numPages")
+        has_more = len(items) >= page_size
+        if isinstance(num_pages, int) and num_pages:
+            has_more = page < num_pages
+        return SearchPage(
+            items=items,
+            page=page,
+            has_more=has_more,
+            cursor=str(page + 1) if has_more else None,
+            total=total if isinstance(total, int) else None,
+            raw=data,
+        )
+
+    # ------------------------------------------------------------ detail
+    def detail(self, id_: str, **kw: Any) -> Dict[str, Any]:
+        """视频详情。id_ 可以是 bvid（BV...）或 aid（数字）。"""
+        key = str(id_).strip()
+        params: Dict[str, Any] = {"aid": key} if key.isdigit() else {"bvid": key}
+        js = self.http.get_json(VIEW, params=params)
+        if js.get("code") != 0:
+            raise RuntimeError(
+                "bilibili view failed: code=%s message=%s"
+                % (js.get("code"), js.get("message"))
+            )
+        d = js.get("data") or {}
+        st = d.get("stat") or {}
+        ow = d.get("owner") or {}
+        return {
+            "bvid": d.get("bvid"),
+            "aid": d.get("aid"),
+            "title": d.get("title"),
+            "desc": d.get("desc"),
+            "pic": d.get("pic"),
+            "pubdate": d.get("pubdate"),
+            "duration": d.get("duration"),
+            "owner": ow.get("name"),
+            "owner_mid": ow.get("mid"),
+            "view": st.get("view"),
+            "danmaku": st.get("danmaku"),
+            "like": st.get("like"),
+            "coin": st.get("coin"),
+            "favorite": st.get("favorite"),
+            "share": st.get("share"),
+            "pages": [
+                {"cid": p.get("cid"), "page": p.get("page"), "part": p.get("part")}
+                for p in (d.get("pages") or [])
+            ],
+            "raw": js,
+        }