Manage collections, blogs, articles, and pages — now with read tools
Shopigent has always supported write tools for collections, blogs, articles, and pages (create, update, delete). What was missing was the ability to explore them first — to list what exists, inspect a specific item, and decide what to act on.
Now every content category has both read and write tools.
New read tools
Collections (5 tools)
Collections organize your products. The new read tools let you browse and inspect them:
List all my collections and show me which ones have
the most products.
Get the "Winter Sale" collection — I need to see
its current products and description.
| Tool | What it does |
|---|---|
list_collections |
Lists all collections (manual + automated) with id, title, handle, sort order |
get_collection_by_id |
Fetches a single collection by GID, including description, image, product count |
Blogs (5 tools)
Blogs hold your articles. Read tools let you discover them:
List all my blogs and show me which ones have the
most recent articles.
| Tool | What it does |
|---|---|
list_blogs |
Lists all blogs with id, title, handle, comment policy |
get_blog_by_id |
Fetches a single blog by GID, including its articles and metadata |
Articles (5 tools)
Articles are individual blog posts. Now you can read them:
List all articles in the "News" blog, ordered by date.
Get the article about the summer sale — I need to
check its publish date.
| Tool | What it does |
|---|---|
list_articles |
Lists all blog articles for a blog, with optional filters |
get_article_by_id |
Fetches a single article by GID, including body, summary, tags, author |
Pages (5 tools)
Pages are static content (About, Contact, etc.):
List all my pages and tell me which ones are unpublished.
Get the "About Us" page and show me its current content.
| Tool | What it does |
|---|---|
list_pages |
Lists all pages with id, title, handle, and status |
get_page_by_id |
Fetches a single page by GID, including body and SEO metadata |
Why this matters
Before these read tools, an agent could only write content — but couldn't discover what exists. The workflow was:
Before: "Delete the About page" → "I don't know which page that is." After: "List my pages. Find 'About'. Delete it."
It's a small change that makes the agent dramatically more useful — especially for repetitive tasks like auditing content, cleaning up old blogs, or restructuring collections.
Full category breakdown
The tools are now organized into 10 categories:
| Category | Tools |
|---|---|
| Products | 28 |
| Content | 16 |
| Metaobjects & Custom Data | 15 |
| Themes | 9 |
| GitHub Theme | 4 |
| Orders | 6 |
| Customers | 5 |
| Discounts | 4 |
| Fulfillments | 4 |
| Inventory | 1 |
Total: 92 tools — every category has both read and write capabilities.