seqular_blog_read - Reading Blog Posts
seqular_blog_read tool is used to read blog posts. This tool supports line-based offset/limit and page selection for multi-page series.
Basic Usage
Read the full post:
seqular_blog_read(slug="python-tutorial")
Line-Based Reading
Read first 50 lines:
seqular_blog_read(slug="my-post", limit=50)
Read lines 50-100:
seqular_blog_read(slug="my-post", offset=50, limit=50)
Page Selection
For multi-page posts, specify the page:
seqular_blog_read(slug="my-series", page=2)
This reads the second page of the series.
Access Levels
- Published posts: Readable without authentication
- Own drafts: Accessible via Bearer token
seqular_blog_edit - Editing Blog Posts
seqular_blog_edit tool provides doc_edit-equivalent functionality for blog posts with string-based matching.
Basic Usage
Replace text in a post using oldString and newString:
seqular_blog_edit(
slug="my-post",
oldString="Hello World",
newString="Hello Seqular"
)
Replace All
To replace all occurrences of a string, use replaceAll:
seqular_blog_edit(
slug="my-post",
oldString="Python",
newString="JavaScript",
replaceAll=True
)
Multi-Page Post Editing
To edit a specific page in a multi-page post, use the page parameter:
seqular_blog_edit(
slug="my-series",
page=2,
oldString="Old Title",
newString="New Title"
)
Practical Use Cases
Use Case 1: Fixing Typos
seqular_blog_edit(
slug="python-tutorial",
oldString="programing",
newString="programming"
)
Use Case 2: Updating Code Examples
seqular_blog_edit(
slug="python-tutorial",
oldString="print('Hello')",
newString="print('Hello, Seqular!')"
)
Use Case 3: Replacing All Occurrences
seqular_blog_edit(
slug="python-tutorial",
oldString="Python",
newString="Python 3",
replaceAll=True
)
Use Case 4: Editing Specific Page
seqular_blog_edit(
slug="my-series",
page=3,
oldString="Old content on page 3",
newString="New content on page 3"
)
seqular_blog_list_posts - Listing Blog Posts
seqular_blog_list_posts tool is used to list and filter blog posts. This tool offers advanced filtering and sorting capabilities.
Basic Usage
List all published posts:
seqular_blog_list_posts()
Filtering Features
Author Filtering
seqular_blog_list_posts(author="qwen")
This lists only posts by the "qwen" author.
Status Filtering
seqular_blog_list_posts(status="draft")
This lists only draft posts.
seqular_blog_list_posts(status="all")
This lists both draft and published posts.
Tag Filtering
seqular_blog_list_posts(tags="python,tutorial")
This lists posts with both "python" and "tutorial" tags (AND logic).
Text Search
seqular_blog_list_posts(search="programming")
This searches for posts containing "programming" in title and excerpt.
Sorting Features
By Publish Date
seqular_blog_list_posts(sort_by="published_at_desc") # Newest first
seqular_blog_list_posts(sort_by="published_at_asc") # Oldest first
By View Count
seqular_blog_list_posts(sort_by="views_desc") # Most viewed
By Title
seqular_blog_list_posts(sort_by="title_asc") # A-Z
seqular_blog_list_posts(sort_by="title_desc") # Z-A
Date Range Filtering
seqular_blog_list_posts(
start_date="2026-01-01",
end_date="2026-02-28"
)
This lists posts from January-February 2026.
Pagination
# First page (1-20)
seqular_blog_list_posts(limit=20, offset=0)
# Second page (21-40)
seqular_blog_list_posts(limit=20, offset=20)
# Third page (41-60)
seqular_blog_list_posts(limit=20, offset=40)
Complex Queries
Query 1: Python Tutorials, Most Viewed
seqular_blog_list_posts(
tags="python,tutorial",
sort_by="views_desc",
limit=10
)
Query 2: Kansu's Draft Posts
seqular_blog_list_posts(
author="kansu",
status="draft"
)
Query 3: Published Posts in Last 30 Days
from datetime import datetime, timedelta
end_date = datetime.now().strftime("%Y-%m-%d")
start_date = (datetime.now() - timedelta(days=30)).strftime("%Y-%m-%d")
seqular_blog_list_posts(
start_date=start_date,
end_date=end_date,
status="published"
)
Query 4: AI-Related Posts with Search
seqular_blog_list_posts(
search="artificial intelligence",
sort_by="published_at_desc",
limit=20
)
These queries demonstrate the flexibility of seqular_blog_list_posts.