BBC Consumer Contracts vs SpecShield
BBC Consumer Contracts
github.comSpecShield
specshield.ioSide by side
| Figure | BBC Consumer Contracts | SpecShield |
|---|---|---|
| Price from | Free | $89/mo |
| Free plan | Yes | Yes |
| Free trial | — | — |
| Open source | — | — |
| Web | — | Yes |
| API | Yes | Yes |
| Self-hosted | Yes | — |
| Plans published | 1 | 3 |
| Spec score · Contract Testing Tools | 8.1 (#8) | 7.7 (#15) |
| Integrations | The project uses the request HTTP client and Joi for response validation. | The product offers a GitHub App and Action, CLI for CI systems, IntelliJ plugin, SARIF output, and an MCP server for AI agents. |
| Purpose | Consumer Contracts lets API consumers define executable JavaScript contracts describing the responses they expect from services. | SpecShield compares OpenAPI descriptions to flag changes that could break existing API consumers and reports results as GitHub checks. |
Plans
SpecShield
- SpecShield FreeFree
- SpecShield Team$89 a month
- SpecShield EnterprisePriced on request
In their own words
BBC Consumer Contracts
BBC Consumer Contracts is a free JavaScript package for executable consumer-driven API contracts. It describes the requests a consumer makes and the responses expected in return. Every contract requires consumer, name, request, and response properties. The package uses the request HTTP client and Joi schemas to check response status codes, headers, and JSON bodies. Optional before and after functions support setup and cleanup, using callbacks or asynchronous functions. Retry behavior accepts numeric or custom settings; the documented default maximum is zero. The consumer-contracts run command validates contracts recursively in a contracts directory or runs one named file. Programmatic callers can pass an array to validateContracts, which runs every contract instead of stopping at the first failure. Installation instructions cover global CLI use and local pnpm development dependencies. It requires Node.js 18 or later and pnpm 10 or later, and supports API and self-hosted use under Apache License 2.0.
SpecShield
SpecShield checks API contracts for changes that could disrupt existing consumers. It compares OpenAPI descriptions and flags removed endpoints, tightened types and newly required fields in pull requests. Its GitHub App posts a diff and compatibility verdict and can block merges when a registered consumer would break. The consumer registry records dependent services for deploy-gate decisions. SpecShield also scores OpenAPI descriptions against OWASP and design rulesets on a 0–100 scale with a letter grade. Connections include a GitHub App and Action, CI CLI, IntelliJ plugin, SARIF output and an MCP server. The free browser diff accepts OpenAPI 3.0 and 3.1 JSON or YAML and says submitted specifications are not persisted. Free costs nothing for one user; Team costs $89 a month or $900/year ($75/mo billed annually).