Auto_Bangumi/docs/en/dev/plugins/points/http-request.md

HTTP Request (http.request)

A transform hook. Every GET request that AB sends (RSS, torrent files, site pages) passes through it. Use it to add a Cookie or to change the User-Agent for a private site. You can change only the headers. AB ignores changes to url and method.

from dataclasses import replace

from pydantic import BaseModel

from ab_sdk import Plugin, hook, points, secret_field


class Options(BaseModel):
    cookie: str = secret_field(description="Site Cookie")


class PrivateSite(Plugin[Options]):
    config_model = Options

    @hook(points.HTTP_REQUEST)
    def auth(self, request):
        if "pt.example.com" not in request.url:
            return None
        return replace(request, headers={**request.headers, "Cookie": self.config.cookie})

• The parameter HttpRequest has method, url and headers. Return a changed copy, or None for no change.
• AB calls this hook for each request. Keep it light. Do not make network requests in it.
• Store the Cookie with secret_field. The WebUI shows only a mask.

Example: examples/plugins/custom-rss-site.