# Bulk SEO Metadata Optimizer

The **Bulk SEO Metadata Optimizer** in SEO Utils allows you to optimize **titles, meta descriptions, and H1 headings** across multiple pages using AI. This tool is perfect for SEOs looking to save time while enhancing metadata for better search engine visibility and click-through rates.

<figure><img src="/files/MpLNcuHC61Shi78ywmfu" alt=""><figcaption><p>Bulk SEO Metadata Optimizer tool</p></figcaption></figure>

### Start Your First Run with the Bulk SEO Metadata Optimizer

To get started, open SEO Utils. On the left-hand sidebar, navigate to the **Utilities** section and click on **Bulk Metadata Optimizer**. This will open the dashboard where you can manage your previous reports or create a new one.

<figure><img src="/files/cE4KthmnFyNZRS3gQWOm" alt="" width="375"><figcaption><p>The tool is under Ultiltes menu</p></figcaption></figure>

To create a new optimization report, click the **Run** button located at the top-right corner of the screen. This will open the **Run Form**, where you can configure your optimization settings.

<figure><img src="/files/GgxayfKZ2oW1EWWFFNNj" alt=""><figcaption><p>Click the "Run" button to start a new run.</p></figcaption></figure>

#### **Add URLs for Optimization**

In the **Run Form**, you’ll see a text box labeled **Enter URLs (one per line)**. Here, you can paste the list of pages you want to optimize. Each URL must be on a separate line.

If you want to optimize all pages under a specific path, you can use the **wildcard (\*)** character. For example:

* Entering `https://example.com/blog/*` will scrape and optimize all pages under the `/blog/` path.
* Entering `https://example.com/category/content/*` will target every page under `/category/content/`.
* If you enter a specific page like `https://example.com/page-1`, only that exact page will be optimized.

<figure><img src="/files/vjSXDyhiwhkBqdL8OGMX" alt=""><figcaption><p>Use wilcard (*) to quickly import URLs</p></figcaption></figure>

{% hint style="info" %}
The wildcard feature is extremely useful for bulk optimization, saving you the hassle of manually adding every single URL.
{% endhint %}

{% hint style="warning" %}
You must **install Google Chrome** on your computer to use the wildcard feature.
{% endhint %}

#### **Choose the AI Model**

The next step is to select the AI model that will generate the optimized metadata. SEO Utils supports multiple AI providers, so you can choose the one that best suits your needs.

* **OpenAI:** You can choose models like GPT-4o, GPT-4o Mini, and more. Get an API key at <https://platform.openai.com/settings/organization/api-keys>
* **Anthropic**: You can use Claude models like Claude 3.5 Sonnet or Claude 3 Ocpus by getting your API key at <https://console.anthropic.com/dashboard>
* **OpenRouter**: This platform gives you access to around 281 different AI models, providing plenty of options. Register an account at <https://openrouter.ai/>

{% hint style="info" %}
You can access the list of models from OpenRouter at <https://openrouter.ai/models>
{% endhint %}

Once you have the API keys, go to the Services settings to enter them. You don’t need to enter all the keys—just input the one for the provider you want to use.

<figure><img src="/files/ARjVIop33DTCwKIkFsaC" alt=""><figcaption><p>Enter LLM Provider API keys</p></figcaption></figure>

* **Local Models via Ollama**: If you prefer not to rely on **cloud APIs**, you can use local models like *Mistral* for **FREE**. To set up Ollama:
  1. Download and install Ollama from <https://ollama.com>.
  2. Open the **Terminal** app on your computer and run the command `ollama pull mistral` to download the model. Ensure your PC meets the requirements specified for the model. For example, Mistral requires at least 16GB of RAM.

<figure><img src="/files/bU7Qf8L4vZd7jomqYpvP" alt=""><figcaption><p>Run the command from your Terminal app to download Ollama models.</p></figcaption></figure>

{% hint style="info" %}
You don’t need an API key to use local models from Ollma. Just keep the Ollama app open, and SEO Utils will find and display all the downloaded models in the dropdown.
{% endhint %}

{% hint style="success" %}
Using local models is cost-effective, but keep in mind they require strong hardware to run efficiently. You can access the list of models at <https://ollama.com/search>
{% endhint %}

#### **Customize Advanced Settings**

Below the AI model selection, there is an option to **Toggle Advanced Settings**. Clicking this will reveal additional customization options to fine-tune the optimization process.

<figure><img src="/files/KmMTkPYlSOjMOL3VyXgx" alt=""><figcaption><p>Advance settings</p></figcaption></figure>

In the **Instruction** field, you can provide a clear instruction for the AI to follow. For example, you might write:

> "You are an SEO expert tasked with improving metadata. Write engaging meta titles, descriptions, and headings that include target keywords and improve click-through rates."

The **Prompt** field is where you can provide SEO metadata that you want to improve using placeholders.

Placeholders are special tags that SEO Utils will automatically replace with the actual content when scraping data from each URL. Here is a breakdown of available placeholders:

* `[title]`: This will be replaced with the page title scraped from the URL.
* `[meta_description]`: This will be replaced with the meta description found on the page.
* `[heading_1]`: This will be replaced with the main H1 heading of the page.
* `[content:50]`: This will include the first 50 words of the page content, and you can edit the number to include any amount of words you prefer, such as 100 or 200 words.

For example, you can define the prompt as follows:

```
Title: [title]
Meta Description: [meta_description]
Heading 1: [heading_1]
Content Preview: [content:50]
```

With this setup, SEO Utils will scrape the page content for each URL, replace the placeholders with the corresponding values, and send them to the AI for optimization.

{% hint style="success" %}
Keep the **Instruction** and **Prompt** fields empty if you want to use the default value that SEO Utils provides.
{% endhint %}

#### **Start the Optimization**

Once you’ve entered your URLs, selected the AI model, and customized the advanced settings, you’re ready to start the optimization process. Click the **Optimize SEO Metadata** button at the bottom of the form.

SEO Utils will process all the URLs and send the scraped data to the selected AI model. Depending on the number of URLs and the model chosen, the optimization may take a few moments to complete.

After the optimization is complete, you will be redirected to the **Report Detail Page** where you can review the results.

### Review the Results

The Report Detail Page provides a clear view of the optimized metadata generated for each URL. For every URL, you can see the **original version** alongside the **improved version** generated by the AI.

<figure><img src="/files/ZlBdNGvHAupO9cmygHAD" alt=""><figcaption><p>Preview changes of each URL</p></figcaption></figure>

Changes are highlighted for easy comparison:

* **Green**: New content that has been added.
* **Red**: Content that has been removed.

If you want to make manual adjustments to any metadata, simply click the **pencil icon** beside the corresponding field. This will allow you to edit the title, meta description, or H1 heading directly.

To modify additional aspects of the optimization, switch to the **Main Content** tab. Here, you can edit the extracted content from the page. If you need to adjust the AI instructions or prompt message for a specific URL, switch to the **Messages** tab. This lets you refine the instructions or prompt to better suit your needs, and placeholders can still be used here for consistency.

<figure><img src="/files/QSJTDpq9ZV4KM26o26l5" alt=""><figcaption><p>Edit data if needed</p></figcaption></figure>

After making changes, you can re-optimize the URL by selecting it and clicking the **Re-optimize** button.

{% hint style="info" %}
**Tip:** You can make small edits to the **Improved version** before [publishing changes](#publish-changes-to-your-website) by clicking the pencil icon next to it.
{% endhint %}

### Publish Changes to Your Website

SEO Utils makes it easy to publish the optimized metadata directly to your website through **Site Integrations**.

{% hint style="info" %}
SEO Utils currently support integration with WordPress. More integrations, such as Shopify, Webflow, and custom platforms, will be added gradually soon.
{% endhint %}

To connect your website:

1. Go to the **Settings** section in the sidebar and select **Site Integrations**.
2. Click **Add Integration** and enter the following details:
   * **Site URL**: The URL of your WordPress site.
   * **Platform**: Select WordPress.
   * **Username** and **App Password**: These can be generated in WordPress.

<figure><img src="/files/6tu3tcPchfX7X3TVYoXp" alt="" width="563"><figcaption><p>Access Site Integrations</p></figcaption></figure>

To generate an App Password in WordPress:

1. Go to your WordPress dashboard.
2. Navigate to **Users > Profile**.
3. Edit a user who has permission to edit posts or pages. If you're unsure, just choose the admin user.
4. Scroll down to the **Application Passwords** section.
5. Generate a new password and copy it.
6. Paste the application password & username into the SEO Utils integration form.

<figure><img src="/files/JvFOnfbCRFTavRkM43aP" alt=""><figcaption><p>Make sure you copy the correct username.</p></figcaption></figure>

<figure><img src="/files/ZLAFuUVdzb1Btuwkp0aB" alt=""><figcaption><p>Create an app password</p></figcaption></figure>

{% hint style="info" %}
SEO Utils will use this application password to change metadata on your website using the SEO Utils WordPress plugin (please install it below).

This application password is **NOT the same as the password** you use to log into your WordPress dashboard, and you can revoke it anytime you need.
{% endhint %}

**Install SEO Utils WordPress plugin**

This plugin will provide a REST API endpoint that lets the SEO Utils app send a request to your website to update metadata.

Please [download it](https://larseov2.s3.us-east-1.amazonaws.com/seo-utils/site-integrations/seo-utils.zip) and install it as a normal WordPress plugin.

**Note**: To update metadata, ensure you have one of the following SEO plugins installed on your WordPress site:

* Yoast SEO
* Rank Math
* All-in-One SEO Pack
* SEOPress
* Slim SEO
* Squirrly SEO

If these plugins are not installed, only the H1 heading can be updated, as it is part of the WordPress core content.

After connecting your site, return to the [**Report Detail Page**](#review-the-results). Click the pencil icon, and you will see a dropdown to select your connected site.

<figure><img src="/files/MVyBK3Js5xYYBee33Xjt" alt=""><figcaption><p>Edit the report to select the added site integration from the previous step.</p></figcaption></figure>

Once the site is selected, a **Publish** button will appear.

<figure><img src="/files/m3YlJYakmvEYUMpFoss9" alt=""><figcaption><p>The "Publish" button appears after connecting to your site.</p></figcaption></figure>

You can publish the following fields:

* Meta Title
* Meta Description
* H1 Heading

{% hint style="danger" %}
Before publishing, always back up your data to avoid any unintended changes.
{% endhint %}

### Bulk Actions

You can select multiple URLs and bulk publish or re-optimize them at once.

<figure><img src="/files/6hvijy64NFuLS7ByPNQt" alt=""><figcaption><p>Bulk Publish URLs</p></figcaption></figure>

{% hint style="info" %}
While the bulk action is running, you can view the log in the Log Panel at the bottom of the page.
{% endhint %}

### Export the Report

If you need to save the results for further analysis or reporting, SEO Utils allows you to export the optimized metadata. On the [Report Detail Page](#review-the-results), click the **Export** button at the top-right corner.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.seoutils.app/guide/bulk-seo-metadata-optimizer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
