PHPackages apicrumbs/core - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. apicrumbs/core ActiveLibrary[Utility & Helpers](/categories/utility) apicrumbs/core ============== High-signal RAG context for PHP AI agents. v1.0.1(2mo ago)01↓100%MITPHPPHP ^8.0.1 Since Mar 4Pushed 2mo agoCompare [ Source](https://github.com/apicrumbs/core)[ Packagist](https://packagist.org/packages/apicrumbs/core)[ RSS](/packages/apicrumbs-core/feed)WikiDiscussions main Synced 2mo ago READMEChangelogDependencies (2)Versions (3)Used By (0) ApiCrumbs Core ============== [](#apicrumbs-core) **The Token-Optimised Context Engine for PHP AI Agents.** **ApiCrumbs** is a zero-dependency PHP engine designed to solve the "JSON Tax." It flattens bloated API responses from 250+ providers into high-signal, **Markdown-KV** context blocks (Crumbs), reducing your LLM token costs by up to 92%. **The Universal PHP Data Supply Chain for LLMs.** **ApiCrumbs** is a Sponsorware framework designed to fetch, normalize, and feed global data—from Companies House to real-time Meteo—directly into LLM contexts. Stop writing custom API wrappers; let the Foundry assemble your Knowledge Base. --- What is it? ----------- [](#what-is-it) The Foundry Core is the backbone of the ApiCrumbs ecosystem. It provides: - **Unified Interface:** One standard way to query 250+ different data providers. - **LLM-Ready Output:** Data is automatically formatted for RAG (Retrieval-Augmented Generation). - **The Registry:** A modular system to install "Crumbs" (Adapters) for specific APIs. --- Why ApiCrumbs? -------------- [](#why-apicrumbs) In 2026, passing raw JSON into **GPT-4.5** or **Claude 4** is an expensive mistake. - \*\* Token ROI:\*\* A 2,400-token Companies House JSON becomes a **180-token Crumb**. - \*\* 2026 Ready:\*\* Built-in support for the April 2026 HMRC MTD v2 and Companies House reforms. - \*\* Local-First:\*\* No data leaves your server. It's a library, not a SaaS. - \*\* The Foundry CLI:\*\* Install, update, and audit 250+ data providers in one command. --- Installation ------------ [](#installation) Install the engine via Composer: ``` # Install the engine via Composer composer require apicrumbs/core ``` --- How it Works ------------ [](#how-it-works) The Foundry uses a Provider Pattern. You install a "Crumb" for a specific data source (e.g., Postcode or Weather), and the Foundry manages the authentication, rate limiting, and output normalization. The Foundry CLI --------------- [](#the-foundry-cli) ApiCrumbs comes with a native CLI to manage your data registry. No dependencies required. ``` # List available providers (Geo, Finance, Compliance, etc.) php vendor/bin/foundry list # Install a free provider (e.g., Postcodes.io) php vendor/bin/foundry install geo/postcodes ``` Quick Start ----------- [](#quick-start) Bake high-signal context for your AI agent in 3 lines of code. ``` use ApiCrumbs\Core\ApiCrumbs; use ApiCrumbs\Providers\Geo\PostcodeProvider; $crumbs = new ApiCrumbs(); // 1. Register the provider $crumbs->registerProvider(new PostcodeProvider()); // 2. Build the "Grounded" context for your LLM echo $crumbs->build('SW1A 1AA'); ``` The Output (Optimised for AI Reasoning) --------------------------------------- [](#the-output-optimised-for-ai-reasoning) ``` ### GEO_LOCATION: SW1A 1AA - **REGION**: London - **WARD**: St James's - **COMPLIANCE**: 2026-Ready --- ``` Founding Sponsors (4/10 Slots Remaining) ---------------------------------------- [](#founding-sponsors-410-slots-remaining) Be one of the first 10 to lock in Business Pro access to the private UK Compliance & Merchant Packs. --- Pro & Global Registry ------------------------- [](#pro--global-registry) While the Core and Free Registry (250+ packages) are MIT-licensed, high-compliance adapters are available via GitHub Sponsorship: Business Pro: UK Gov Stack (HMRC, Companies House, Crime API, NHS). Global Ops: USA (SEC/Census), EU (VIES), and AU Data Packs + Custom Adapter Requests. Become a Sponsor to Unlock Pro Repositories --- Documentation ------------- [](#documentation) Auto-generated documentation for every provider in the registry is available at docs.apicrumbs.io. --- Contributing Found a public API? Add it to the Free Registry! Submit a PR to the Registry Repository. ### Health Score 35 — LowBetter than 80% of packages Maintenance87 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity40 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~1 days Total 2 Last Release 74d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d2e1832344dfcb68339267a5cb20ab1bf2f81ca3d8e5a429e9455b19dd6ef961?d=identicon)[apicrumbs](/maintainers/apicrumbs) --- Top Contributors [![apicrumbs](https://avatars.githubusercontent.com/u/70859732?v=4)](https://github.com/apicrumbs "apicrumbs (25 commits)") ### Embed Badge ![Health badge](/badges/apicrumbs-core/health.svg) ``` [![Health](https://phpackages.com/badges/apicrumbs-core/health.svg)](https://phpackages.com/packages/apicrumbs-core) ``` ### Alternatives [shlinkio/shlink A self-hosted and PHP-based URL shortener application with CLI and REST interfaces 4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin DHL Parcel plugin for Magento 2 11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)