# Laravel AI Blog

**Install it, and your blog thinks.** Laravel AI Blog is a free, open-source blog package for Laravel 10 to 13. It
plans topics, drafts *with* you, scores every post for on-page SEO, links itself, keeps itself fresh — and lets
Claude, ChatGPT, Claude Code or any MCP agent write to it.

- **Headless by default.** Models, migrations, a trait for your *existing* Post model. No admin panel forced on you. Flip one flag for `/blog` routes, Blade components, RSS and JSON-LD.
- **SEO that nobody else ships.** An on-page score with plain-English fixes, internal-link suggestions with anchor text, stale-post detection, BlogPosting + FAQPage schema.
- **AI as your editor, not your ghostwriter.** Built on the official [laravel/ai](https://github.com/laravel/ai) SDK — any provider. Brief → draft, meta descriptions, rewrites, refresh suggestions, translations. Everything lands as a **draft**. Nothing auto-publishes unless you say so.
- **Agent-ready.** A built-in [laravel/mcp](https://github.com/laravel/mcp) server: *"write a post on X, score it, link it to related posts, schedule for Monday."*
- **Free. MIT.** No Nova license, no Filament lock-in, no SaaS tether.

Install: `composer require byteminus/laravel-ai-blog`

Website: https://byteminus.github.io/laravel-ai-blog/ · Docs: https://byteminus.github.io/laravel-ai-blog/docs/ · Repository: https://github.com/byteminus/laravel-ai-blog

## Frequently asked questions

**What is Laravel AI Blog?** Laravel AI Blog is a free, open-source blog package for Laravel. It adds posts, categories and tags, an on-page SEO score with fixes, internal link suggestions, AI drafting through laravel/ai and an MCP server so AI agents can write drafts. Install it with composer require byteminus/laravel-ai-blog.

**Which Laravel and PHP versions does it support?** Laravel 10, 11, 12 and 13 on PHP 8.2 to 8.5. Both the newest and the oldest allowed dependencies are tested on every push.

**Does it work without an AI provider?** Yes. SEO scoring, link suggestions, structured data, the RSS feed and the blog routes need no API key. The AI features are optional and use laravel/ai when you install it, with any provider it supports.

**Will the AI publish posts by itself?** No. Everything the AI or an agent writes is saved as a draft, and the MCP server has no publish tool. A post goes live when a person publishes it, or when the scheduler reaches a time set with schedule() or the schedule-post tool.

**Can I keep my existing Post model?** Yes. Add the HasBlogSeo trait to your model, override any field names that differ, and point ai-blog.models.post at it in the config.

**How do I connect Claude or ChatGPT to my Laravel blog?** Enable the MCP server in config/ai-blog.php and protect it with middleware. Claude Code connects with claude mcp add and a bearer token. Claude.ai and ChatGPT custom connectors use laravel/mcp's OAuth support with Passport.

**Does it add SEO tags to the blog pages?** Yes, when you enable the routes. Post pages get a canonical URL, Open Graph and Twitter cards, publish and modified times, an RSS link and BlogPosting JSON-LD, plus FAQPage JSON-LD when the post has question headings. Index, category and tag pages get descriptions, canonical URLs and prev and next links.

**Is it free?** Yes. Laravel AI Blog is MIT licensed, with no paid tier, no Nova or Filament license and no SaaS account.