Skip to content

Identify crawlers from the shared generated registry (#86) - #94

Merged
cport1 merged 2 commits into
mainfrom
feat/86-generated-registry
Sep 23, 2026
Merged

cport1 merged 2 commits into
mainfrom
feat/86-generated-registry

Conversation

@cport1

@cport1 cport1 commented Sep 23, 2026

Copy link
Copy Markdown
Contributor

Adopts the crawler registry generated from WebDecoy/app (sdk/src/registry/agents.generated.php, schema 2, 182 agents with their policy behavior) as the one crawler table. AgentRegistry is its only reader; GoodBotList keeps its API and maps registry categories to the plugin's.

Mapping (registry → plugin): search_crawler, ai_search_crawler → search_engine; training_crawler, ai_agent, ai_assistant → ai_crawler; fetcher → social; monitoring, seo_crawler, feed_reader, archiver → themselves. Security scanners, scraping frameworks, headless browsers and HTTP clients are not good bots and score exactly as before.

Intentional behaviour changes (in the changelog): 128 more crawlers are recognised; with Block AI crawlers on, AI agents/assistants and the newly recognised AI crawlers are refused too; the two W3C validators are no longer listed (they were never allowed).

Drift guards: tests/AgentRegistryTest.php replays the shared parity vectors, pins the schema, the mapping, the applebot/applebot-extended ordering and every crawler the old table named. A new CI job runs the SDK tests on PHP 7.4.

Depends on WebDecoy/app#1275 (behavior in the PHP export, seven plugin-only agents added to the registry); the artifact here was generated from that branch.

Closes #86.

The plugin kept its own table of 54 known bots with its own categories; the
dashboard, the edge sensor and the Node SDK use the registry generated from
WebDecoy/app. A crawler could be named one thing here and another in the
report about it, and the crawler policy vocabulary (#995) had no PHP reader.

sdk/src/registry/agents.generated.php is the shared table (schema 2, 182
agents, each with its policy behavior) and AgentRegistry is its only reader.
GoodBotList keeps its public API and maps registry categories to the
plugin's coarser ones: search and AI-search crawlers are search engines;
training crawlers, AI agents and AI assistants are AI crawlers; fetchers
are social; scanners, scraping frameworks, headless browsers and HTTP
clients are not good bots and score as before. Source-address verification
is keyed by registry id. The seven crawlers only this plugin listed are now
in the registry (WebDecoy/app#1275); the two W3C validators are dropped.

tests/AgentRegistryTest.php replays the shared parity vectors and pins the
schema, the mapping and every previously listed crawler. CI now runs the SDK
tests.
@cport1
cport1 merged commit 5ca0d17 into main Sep 23, 2026
4 checks passed
@cport1
cport1 deleted the feat/86-generated-registry branch September 23, 2026 03:27
@cport1 cport1 mentioned this pull request Sep 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Reconcile WordPress bot categories with the canonical generated registry

1 participant