CreatorKitDocumentation

VideoSEO Kit

YouTube SEO & AI tools script · version 1.0.0 · built on Laravel 13

Overview

VideoSEO Kit is a ready-to-run website offering 28 tools for YouTube creators, with a blog, visitor accounts and a complete administration panel.

Requirements

All PHP libraries are included in the vendor folder: Composer is not needed to install the script.

Installation

  1. Create an empty MySQL database and a database user in your hosting panel.
  2. Upload the content of the videoseo-kit folder to your server, hidden files included (.htaccess, .env.example).
  3. Point your domain to the public folder. If your hosting does not let you choose the web root (many shared hostings), upload everything into the web root as it is: the .htaccess file at the top forwards requests to public.
  4. Make these folders writable (755 or 775): storage, bootstrap/cache, public/assets/uploads. The project folder itself must be writable once, so the installer can create the .env file.
  5. Open your domain in a browser. The installer checks the server, asks for the database access and the administrator account, then creates everything.
  6. Log in and open Admin.
nginx: use the standard Laravel server block, with root set to the public folder and try_files $uri $uri/ /index.php?$query_string;.

To run the installer again, delete storage/installed and empty the database.

License activation

After the installation, log in as administrator. The admin panel opens on License & updates and stays locked until your license is activated. Your public site works in the meantime.

  1. Find your license key: it is in the email you received after your purchase (subject and sender: CreatorKit, sent by Freemius). You can also find it at any time in the customer portal linked in that email.
  2. Paste it in the License key field and click Activate.

One license is valid for one website. To move your site to another domain, open License & updates on the old site and click Reset license, then activate the key on the new domain. If the old site no longer exists, write to support@creatorkit.online with the email address used for the purchase and we release the key for you.

No license is asked on a local address (localhost, 127.0.0.1, *.test, *.local), so you can prepare your site on your computer.

Activation sends your license key, your domain name and the installed version to our license server, which confirms the key with Freemius, the company that processes our sales. Nothing else is sent. If the license server cannot be reached later, your site and your admin panel keep working.

Local installation

  1. Install PHP 8.3+ (on Windows or macOS, Laravel Herd installs it in one step).
  2. Open a terminal in the videoseo-kit folder and run php artisan serve.
  3. Open http://127.0.0.1:8000 and choose SQLite in the installer: no database server is needed.

First steps

Do thisWhere
Set the site name, home heading and footerSettings › General
Upload your logo and favicon, choose the main colourMedia, then Settings › Appearance
Add the YouTube API keySettings › YouTube API & limits
Configure the AI toolsSettings › AI tools
Paste your ad codes and ads.txt lineSettings › Advertising
Set up outgoing emailSettings › Email (SMTP)
Review the Privacy Policy, About and DMCA pagesPages

The dashboard lists what is still missing.

YouTube API key

  1. Open Google Cloud Console and create a project.
  2. In APIs & Services › Library, enable YouTube Data API v3.
  3. In APIs & Services › Credentials, create an API key.
  4. Paste it in Settings › YouTube API & limits.

The free quota is counted per day. To protect it, answers are cached and each visitor is limited to 30 tool uses per 10 minutes (changeable). The channel search costs the most quota per use. The keyword-based generators (tags, hashtags, titles) use YouTube search suggestions and consume no quota.

Sites that use YouTube API Services must show a privacy policy that mentions them and links to the YouTube Terms of Service and the Google Privacy Policy. The default Privacy Policy page already contains this section.

AI tools

In Settings › AI tools:

SettingMeaning
ProviderAnthropic (Claude), or OpenAI and compatible services.
API keyThe key of your account at the provider. Every use is billed to this account.
ModelThe exact model name from the provider's documentation. A small, fast model keeps the cost low.
API addressOnly for OpenAI-compatible services: their base URL, for example https://example.com/v1.
Who can use the AI toolsMembers only (recommended) or everyone.
Uses per person per dayDefault 10. Administrators are not limited.
AI calls cost money. Keep the tools for members, keep a daily limit, and set a spending limit in your provider account.

The text typed by a visitor is sent to the provider you chose. The default Privacy Policy mentions it.

Advertising

Settings › Advertising has one field per position: head script, top of the page, under the tool, middle of the article, end of the article, sidebar, home page, and the content of ads.txt. Empty positions print nothing. The "middle of the article" unit is inserted automatically before the third heading of long articles.

Ads can be switched off for a single tool or page (Show ads on this page). They never appear on login, registration, account and error pages.

If you use a consent platform, for example Google's consent message, keep the built-in cookie notice off (Settings › Code & cookies).

Tools, pages, blog, menus

Tools

Each tool page has a name, an address, an engine (the program behind it), a category, an SEO title, a meta description, and an article shown under the tool. You can disable a tool, mark it as popular, and reorder with Position. Several pages can use the same engine with different articles.

Articles and the editor

Articles are written in HTML with a small toolbar (headings, bold, lists, links, images) and a preview. To add a FAQ that also produces FAQ structured data, wrap it like this:

<div class="faq-section">
<h2>Frequently asked questions</h2>
<h3>The question?</h3>
<p>The answer.</p>
</div>

Pages

Normal pages, plus two form types: Contact form and Report form. Messages are stored in Messages and emailed to the address set in Settings › General.

Blog

Posts have a draft/published status and a publication date. A future date schedules the post.

Menus and redirects

Menus manages the header and footer links. Redirects sends an old address to a new one (301 or 302).

Media

Upload JPG, PNG, WebP, GIF or ICO images up to 5 MB, then paste the address shown (for example assets/uploads/logo.png) where an image is asked.

Appearance

Logo for light and dark themes, favicon, main colour, default theme (light, dark or the visitor's device) and additional CSS. Without a logo, the site name is displayed.

Email

Fill in Settings › Email (SMTP) with the SMTP details of your mailbox. It is used for "forgotten password" emails and contact notifications. While it is empty, the mail settings of the .env file apply (by default, emails are only written to the log).

Users & limits

Visitors can create an account, change their details and delete their account. Registration can be closed in Settings › General. Administrators are created in Users by choosing the role Administrator.

Behind Cloudflare or another CDN, set TRUSTED_PROXIES=* in .env. Otherwise all visitors appear to come from the CDN and share the same usage limit.

SEO

Demo mode

Set DEMO_MODE=true in .env to let people visit the admin panel without being able to save anything. The login page then shows an Open the admin demo button that needs no password, email addresses are hidden in the admin panel, and the daily limit of the AI tools is counted per visitor. Use it only on a site made for demonstration.

Translation

Interface texts of the public site use Laravel's translation function. To translate them, create lang/xx.json (for example lang/fr.json) containing "English text": "Translated text" pairs, and set APP_LOCALE=xx in .env. Tool articles, pages and posts are edited in the admin panel.

For developers

PathContent
app/Tools/Registry.phpList of tool engines: form fields and handler of each tool.
app/Tools/Handlers.phpYouTube data tools.
app/Tools/AiHandlers.phpAI tools and their prompts.
app/Services/YouTube.php, Ai.phpAPI clients.
app/Http/ControllersSite, accounts, installer and admin.
resources/viewsBlade templates. Browser tools are in resources/views/tools.
public/assetsapp.css, app.js, admin.css, admin.js.
database/seeders/content.phpDefault content.

Adding a tool

  1. Add an entry in Registry::all() with its fields and a run handler.
  2. Write the handler. It receives an Input object and returns a list of blocks (chips, text, kv, images, cards, note), described at the top of Registry.php. Throw a ToolError to show a message to the visitor.
  3. Create the page in Admin › Tools and choose the new engine.

Updating

When a new version is published, a notice appears on the dashboard. License & updates shows what is new and a download button (the link is valid for one hour).

  1. Back up your files and database.
  2. Upload the new files over the old ones, except .env, storage and public/assets/uploads.
  3. If the changelog mentions database changes, run php artisan migrate --force (or use the update page when provided).
  4. Clear the cache from the dashboard.

Troubleshooting

ProblemWhat to check
Blank page or error 500Folder permissions on storage and bootstrap/cache; PHP version; the log in storage/logs.
Only the home page worksmod_rewrite is off, or the .htaccess files were not uploaded.
"This tool is temporarily unavailable"The YouTube or AI key is missing. Logged in as administrator, the message says which one.
"The daily limit of this tool has been reached"The daily YouTube API quota is used up. It resets at midnight Pacific Time.
No email arrivesSMTP settings; the sender address must belong to your domain.
Everyone hits the usage limit at onceSet TRUSTED_PROXIES=* when the site is behind a CDN.

Support

Questions and bug reports: support@creatorkit.online. Please include the email address used for the purchase, your site address and the steps that lead to the problem.

Credits

Built with the Laravel framework and its dependencies (MIT and compatible licences, see each package in vendor). The interface, icons, styles and scripts were made for this product and use no third-party asset. YouTube is a trademark of Google LLC; this product is not affiliated with YouTube or Google.

Changelog

1.0.0 – First release.

Need help? Write to support@creatorkit.online with the email address used for your purchase and your site address.