How to turn one article title or a topic sheet into published SEO content
AI Article Agent can run a single article through Quick add task, or process a full spreadsheet through Batch import topics. This guide walks through setup, task input, generation, publishing, and troubleshooting.
Use Quick add task for one article, or Batch import topics when you already have a spreadsheet of ideas.
Install, pin, and open the extension
Add AI Article Agent from the Chrome Web Store. Pin it from the browser extensions menu, then open the side panel from the toolbar.
Fill in API keys
Open API Key Settings and add the model/search keys you want to use. At minimum, add a Gemini API key. Serper is recommended for image and video research.
Use Quick add task for one article
Open Quick add task and fill in Article title and Target keyword. The article title is saved internally as Topic, because the generation pipeline uses Topic as the final article title.
Content direction is optional, but useful when you want to control the angle, search intent, comparison focus, product positioning, or reader promise.
Use Batch import topics for many articles
Download the template, fill the spreadsheet, then upload the .xlsx file. Required columns are Topic and Target Keyword. Add Content Direction or 内容方向 when you want to steer each article.
Choose a save method and start
Choose Download HTML, Google Drive, or Shopify. For Google Drive and Shopify, connect the target account first. Then click Start or use Add & start from Quick add task.
Quick add and the spreadsheet template use the same underlying task data. Only the first two fields are required.
| Field | Required? | How it is used |
|---|---|---|
Article title / Topic | Required | The final article title. The backend still stores this as Topic for compatibility with the spreadsheet workflow. |
Target keyword | Required | The main SEO keyword used for research, outline planning, and optimization. |
Content direction | Optional | Guides the article angle, search intent, reader need, comparison logic, product positioning, or editorial constraints. |
Target audience | Optional | Defines who the article is written for, such as beginners, Shopify merchants, SaaS buyers, or technical users. |
Product and Product USP | Optional | Helps the writer naturally connect the article to a product and its main selling points. |
Product URL, Internal links, Product image URL | Optional | Provides links and visual references that can be used when assembling and publishing the article. |
Quick add task
Create a single task directly in the interface. This is best when you want to generate one article immediately without preparing a topic plan spreadsheet.
Batch import topics
Upload a spreadsheet for many articles. Use this for planned content calendars, topic clusters, affiliate batches, Shopify content campaigns, or agency production.
Save method
Download a self-contained HTML file, save the final article to Google Drive, or publish directly to a Shopify blog.
Prompt and model settings
Set author name, output language, model choices, and extra instructions for each generation stage.
Reference images
Upload product or brand images for better visual matching when the image generation stage creates article images.
Task history
Pending and completed tasks are separated. Completed history stays available, while large local files expire after the retention period shown in the extension.
Once you start a run, every pending task moves through these stages automatically.
Deep research
The system researches the target keyword, competitor content, facts, and relevant source material.
Video intelligence
When search keys are available, relevant videos can be used as supplementary research material.
Outline generation and fact check
The research is turned into an SEO-ready outline, then checked before full writing begins.
Draft writing and quality scoring
The article is drafted, scored, and retried when quality is below the configured threshold.
HTML assembly and images
The article is converted into structured HTML with schema markup and article images.
Publish or save
The final output is saved locally as HTML, sent to Google Drive, or published to Shopify.
What is the difference between Quick add task and Batch import topics?
Quick add task is for one article. Batch import topics is for many articles in a spreadsheet. Both create the same kind of pending task and use the same generation workflow.
Why does the interface say Article title but the template says Topic?
The original spreadsheet workflow used Topic as the field name. In practice, Topic becomes the final article title, so the quick add interface labels it Article title to make the behavior clearer.
Is Content direction required?
No. Article title and Target keyword are the only required fields. Content direction is recommended when you want a specific angle, such as a beginner guide, comparison, product-led article, buying intent article, or troubleshooting tutorial.
What happens if I stop a run?
Completed tasks stay completed. When you start again, AI Article Agent continues with pending tasks instead of re-queuing completed history.
Why do old local downloads expire?
Large local files such as HTML files, generated images, drafts, and research cache are retained temporarily to control server storage. Completed history stays visible, but expired local downloads cannot be downloaded again from server storage.