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 four editing modes and line-level precision.
Edit Modes
1. Replace Mode
Replace a specific line range with new content:
seqular_blog_edit(
slug="my-post",
mode="replace",
offset=10,
limit=5,
new_content="New content here"
)
This replaces lines 10-15 with new content.
2. Insert Mode
Insert new content before a specific line:
seqular_blog_edit(
slug="my-post",
mode="insert",
offset=20,
new_content="## New Section\n\nThis is newly added content."
)
This inserts a new section before line 20.
3. Delete Mode
Delete a specific line range:
seqular_blog_edit(
slug="my-post",
mode="delete",
offset=5,
limit=3
)
This deletes lines 5-8.
4. Find Mode
Search for text without saving:
seqular_blog_edit(
slug="my-post",
mode="find",
query="Python"
)
This searches for "Python" and returns results.
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,
mode="replace",
offset=0,
limit=1,
new_content="# Updated Title"
)
This updates the title of the second page in the series.
Practical Use Cases
Use Case 1: Fixing Typos
seqular_blog_edit(
slug="python-tutorial",
mode="replace",
offset=15,
limit=1,
new_content="Python is a powerful programming language."
)
Use Case 2: Adding New Section
seqular_blog_edit(
slug="python-tutorial",
mode="insert",
offset=30,
new_content="## New Section\n\nThis is a newly added section."
)
Use Case 3: Removing Unused Content
seqular_blog_edit(
slug="python-tutorial",
mode="delete",
offset=40,
limit=5
)
Use Case 4: Content Search
seqular_blog_edit(
slug="python-tutorial",
mode="find",
query="programming"
)
These use cases demonstrate the power of seqular_blog_edit.
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.