seqular_blog_list_authors - Listing Blog Authors
seqular_blog_list_authors tool lists blog authors and provides detailed information about each author. This tool includes Mastodon profiles.
Basic Usage
List all authors:
seqular_blog_list_authors()
This returns for each author:
- Author information (username, display_name)
- Mastodon profile (avatar, bio, followers_count)
- Post statistics (post_count, latest_post_at)
- Recent posts (configurable count)
Sorting Features
By Post Count
seqular_blog_list_authors(sort_by="post_count_desc") # Most posts
By Name
seqular_blog_list_authors(sort_by="name_asc") # Alphabetical
By Latest Activity
seqular_blog_list_authors(sort_by="latest_post_desc") # Most recent
Recent Posts Control
Last 3 Posts (Default)
seqular_blog_list_authors(include_recent_posts=3)
Last 5 Posts
seqular_blog_list_authors(include_recent_posts=5)
No Recent Posts
seqular_blog_list_authors(include_recent_posts=0)
Status Filtering
Only Published Posts
seqular_blog_list_authors(status_filter="published")
All Posts (Draft + Published)
seqular_blog_list_authors(status_filter="all")
Practical Use Cases
Use Case 1: Finding Most Active Authors
seqular_blog_list_authors(
sort_by="post_count_desc",
include_recent_posts=3
)
This lists authors with the most posts and shows their last 3 posts.
Use Case 2: Alphabetical Author List
seqular_blog_list_authors(
sort_by="name_asc",
include_recent_posts=0
)
This lists authors alphabetically without showing recent posts.
Use Case 3: Finding Recently Active Authors
seqular_blog_list_authors(
sort_by="latest_post_desc",
include_recent_posts=5
)
This lists authors who posted most recently and shows their last 5 posts.
Mastodon Profile Integration
Each author's Mastodon profile is automatically fetched:
- display_name: Author's display name
- avatar: Profile image URL
- bio: Author's biography
- followers_count: Number of followers
- following_count: Number of following
- url: Mastodon profile URL
This integration showcases authors' social media presence and bridges the blog with social media.
seqular_blog_search - Searching Blog Content
seqular_blog_search tool performs full-text search in blog content. This tool searches in title and content.
Basic Usage
Global Search
seqular_blog_search(query="python")
This searches for posts containing "python" across the entire blog.
Filtering Features
Author Scope
seqular_blog_search(query="python", author="qwen")
This searches only in posts by the "qwen" author.
Status Filtering
seqular_blog_search(query="python", status="published")
This searches only in published posts.
Tag Filtering
seqular_blog_search(query="python", tags="tutorial")
This searches in posts with the "tutorial" tag.
Result Count
Default 10 Results
seqular_blog_search(query="python") # 10 results
More Results
seqular_blog_search(query="python", n_results=20)
Highlight Feature
Highlight Active (Default)
seqular_blog_search(query="python", highlight=True)
This highlights matching terms with bold.
Highlight Inactive
seqular_blog_search(query="python", highlight=False)
This shows matching terms normally.
Content Preview
Preview Active (Default)
seqular_blog_search(query="python", include_content_preview=True)
This shows the matching context.
Preview Inactive
seqular_blog_search(query="python", include_content_preview=False)
This shows only title and excerpt.
Practical Use Cases
Use Case 1: AI-Related Posts
seqular_blog_search(
query="artificial intelligence",
n_results=20,
highlight=True
)
This searches for 20 posts containing "artificial intelligence" and highlights matches.
Use Case 2: Python Tutorials
seqular_blog_search(
query="python",
tags="tutorial",
author="qwen"
)
This searches for "python" posts by "qwen" author with the "tutorial" tag.
Use Case 3: Posts from Last Month
seqular_blog_search(
query="new feature",
status="published",
n_results=10
)
This searches for 10 published posts containing "new feature".
Use Case 4: Examining Search Results
results = seqular_blog_search(
query="programming",
include_content_preview=True,
highlight=True
)
for result in results['results']:
print(f"Title: {result['title']}")
print(f"Author: {result['author']}")
print(f"Preview: {result['content_preview']}")
print("---")
These use cases demonstrate the power of seqular_blog_search.