Skip to content

backlink-guard 0.6.0

Choose a tag to compare

View all tags
@zhuyansen zhuyansen released this 16 Oct 09:24
v0.6.0
bd8020b

中文说明在英文之后。

What to do with each site. Every row now ends in an action: skip, look first, free only, low value or submit, with its reason. It reads the verdict, the link policy and the value together, so you no longer combine four columns yourself. On 100 labelled sites no rule had been tuned on, 3 of the 40 that Ahrefs marks SPAM come out submit; all 10 bad sites around shared checkout links come out skip; the ten well-known directories and communities come out submit. Grades are the same as in 0.5.

New

  • Action (action, action_reason): skip (avoid, nobody can reach it, or findings against it and almost no visitors), look first (a check failed or was refused, it may be one of an operator's several sites, or two findings stand against it), free only (it sells followed links or wants a link or badge back: list for free, never pay or link back), low value (nothing against it, under 1,000 visits a month), submit.
  • Networks across checks: page templates and analytics or ads accounts are remembered on your machine for a year, so a site checked on its own is still matched against one operator's sites seen before. Block pages and platform default titles do not count as templates.
  • Reports for the shared spam-link list: when a check finds one operator's sites that the list lacks, and at least half of them have something else against them, the report ends with a link to a filled-in report form (networks in the JSON). Opening it sends nothing; the list now takes a whole network in one report.
  • Install: with pip or uvx straight from this repository (PyPI is on its way), or as a Claude Code plugin.

Changed

  • Quotes start and end on whole words, with … where they cut the page short.
  • Your log, the paid answers and the networks seen before live in ~/.backlink-guard, so an installed command keeps one log wherever it runs.
  • The README is shorter: a quick start, the action column and how well it works. The nine tests moved to docs/validation.md.

Upgrading from 0.5

  • Run from a clone that has ./state, nothing moves. An installed command uses ~/.backlink-guard; BACKLINK_GUARD_STATE puts it anywhere else.
  • --json rows gain action and action_reason, and the result gains networks. grade, risk, policy and value are unchanged.

Install

pip install "git+https://github.com/zhuyansen/backlink-guard"
backlink-guard vet <site> --free

In Claude Code:

claude plugin marketplace add zhuyansen/backlink-guard
claude plugin install backlink-guard@backlink-guard

Python 3.10 or newer, no dependencies.

中文

每个站该怎么做，直接告诉你。 每一行现在都会给出一个建议：跳过（skip）、先看看（look first）、只免费提交（free only）、价值低（low value）、可以提交（submit），并附上理由。它把结论、链接政策和价值放在一起判断，不用再自己去合并四列。在 100 个规则从没见过的标注站上，Ahrefs 标了 SPAM 的 40 个里只有 3 个被建议提交；和共用收款链接有关的 10 个坏站全部建议跳过；十个知名目录和社区全部建议提交。结论和 0.5 完全一样。

新增

  • 建议（action、action_reason）：
    • 跳过：判 avoid、没人能访问，或者有问题且几乎没人访问。
    • 先看看：有检查失败或被拒绝、可能是同一个人运营的多个站之一，或者有两条问题。
    • 只免费提交：它卖传权重的链接，或要求回链、挂徽章；可以免费收录，但别付钱、别回链。
    • 价值低：没有问题，但月访问不到 1,000。
    • 可以提交：以上都不是。
  • 跨批次识别站群：页面模板和统计、广告账号会在本机记一年。单独查一个站时，也会和之前查到的同一运营者的站比对。拦截页和平台默认标题不算模板。
  • 向共享名单举报：检查中发现名单上没有的站群，并且其中至少一半还有别的问题时，报告最后会附上一个已经填好的举报链接（JSON 里是 networks）。打开链接不会发出任何东西；名单现在也支持一份举报提交整个站群。
  • 安装方式：用 pip 或 uvx 直接从这个仓库安装（PyPI 版本稍后上线），或者作为 Claude Code 插件安装。

改动

  • 引用的原文从完整的词开始、到完整的词结束，截断处加「…」。
  • 提交记录、付费结果和查到过的站群都存在 ~/.backlink-guard，装好的命令在哪个目录运行都用同一份记录。
  • README 精简了：快速上手、建议列和效果如何。九轮测试挪到 docs/validation.zh-CN.md。

从 0.5 升级

  • 在已有 ./state 的克隆目录里运行，什么都不用动。装好的命令用 ~/.backlink-guard；设置 BACKLINK_GUARD_STATE 可以换到别处。
  • --json 的每一行新增 action 和 action_reason，结果里新增 networks。grade、risk、policy、value 都没变。

安装

pip install "git+https://github.com/zhuyansen/backlink-guard"
backlink-guard vet <站点> --free

在 Claude Code 里：

claude plugin marketplace add zhuyansen/backlink-guard
claude plugin install backlink-guard@backlink-guard

需要 Python 3.10 或更新版本，没有任何依赖。

Assets 2
Loading