hatena-blog-atom-ruby

Ruby scripts for fetching, posting, and updating blog entries on Hatena Blog using the AtomPub API.

Features

Fetcher (hatena_blog_fetcher.rb)

• Fetch blog posts by URL (date-based, entry ID, or edit URL format)
• Extract metadata: title, content, categories, draft status, entry ID
• Multiple output formats (full, raw markdown, title, datetime, URL)
• Date-based URL search prefers URL-exact match; falls back to ±1 hour time tolerance with a stderr warning

Poster (hatena_blog_poster.rb)

• Post new blog entries from Markdown files
• Draft/publish mode support

Updater (hatena_blog_updater.rb)

• Update existing blog entries by ID or URL
• Preserve or modify categories and publication datetime
• Draft/publish mode support

Prerequisites

• mise (recommended Ruby version manager — installs the version pinned in mise.toml)
• Ruby (see mise.toml)
• Bundler (ships with the mise-managed Ruby)
• Hatena Blog API credentials

Installation

git clone https://github.com/shifumin/hatena-blog-atom-ruby.git
cd hatena-blog-atom-ruby
mise install         # installs the Ruby version from mise.toml
mise exec -- bundle install

If you don't use mise, plain bundle install works too — just make sure your active Ruby matches the version in mise.toml.

Configuration

Set the following environment variables:

export HATENA_ID='your-hatena-id'
export HATENA_BLOG_ID='your-subdomain.hatenablog.com'
export HATENA_API_KEY='your-api-key'

Variable	Description	Example
HATENA_ID	Your Hatena ID	your-hatena-id
HATENA_BLOG_ID	Your blog domain	your-subdomain.hatenablog.com
HATENA_API_KEY	API key from blog settings	(see below)

Obtaining Your API Key

1. Log in to Hatena Blog
2. Go to: https://blog.hatena.ne.jp/{HATENA_ID}/{BLOG_ID}/config/detail
3. Scroll to "AtomPub" section
4. Click "APIキーを表示" (Show API Key)

Usage

Fetcher

Fetch a blog entry by URL:

ruby hatena_blog_fetcher.rb [OPTIONS] URL

Options

Option	Description
-r, --raw	Output raw Markdown content only
-t, --title	Output title only
-d, --date	Output publication datetime only
-u, --url	Output URL only
-h, --help	Display help message

Supported URL Formats

• Date-based: https://example.hatenablog.com/entry/2024/01/01/123456
• Entry ID: https://example.hatenablog.com/entry/20240101/1234567890
• Edit URL: https://blog.hatena.ne.jp/{user}/{blog}/edit?entry={entry_id} (admin URL — entry ID is read from the entry query parameter)

Examples

# Full entry information
ruby hatena_blog_fetcher.rb https://example.hatenablog.com/entry/2024/01/01/123456

# Raw Markdown only
ruby hatena_blog_fetcher.rb -r https://example.hatenablog.com/entry/2024/01/01/123456

# Title only
ruby hatena_blog_fetcher.rb -t https://example.hatenablog.com/entry/2024/01/01/123456

Output Example

============================================================
タイトル: サンプル記事タイトル
投稿日時: 2024-01-01 12:34:56
URL: https://example.hatenablog.com/entry/2024/01/01/123456
カテゴリ: Ruby, API
下書き: no
エントリーID: 13574176438046791234
============================================================
本文（Markdown）:
------------------------------------------------------------
# 見出し

本文のMarkdownコンテンツ
============================================================

Poster

Post a new blog entry from a Markdown file:

ruby hatena_blog_poster.rb [OPTIONS]

Options

Option	Description
-t, --title TITLE	Article title (required)
-f, --file FILE	Markdown file path (required)
-p, --publish	Publish immediately (default: draft)
-h, --help	Display help message

Examples

# Post as draft
ruby hatena_blog_poster.rb -t "My Article" -f article.md

# Publish immediately
ruby hatena_blog_poster.rb -t "My Article" -f article.md -p

Updater

Update an existing blog entry:

ruby hatena_blog_updater.rb [OPTIONS]

Options

Option	Description
-u, --url URL	Entry URL (mutually exclusive with -i)
-i, --id ID	Entry ID (mutually exclusive with -u)
-t, --title TITLE	Article title (required)
-f, --file FILE	Markdown file path (required)
-p, --publish	Publish immediately (default: draft)
-c, --categories CATEGORIES	Categories (comma-separated)
--updated DATETIME	Publication datetime (ISO8601 format)
--preserve	Preserve existing categories/datetime when not specified
-h, --help	Display help message

Examples

# Update by entry ID
ruby hatena_blog_updater.rb -i 13574176438046791234 -t "Updated Title" -f content.md

# Update by URL
ruby hatena_blog_updater.rb -u https://example.hatenablog.com/entry/2024/01/01/123456 \
  -t "Updated Title" -f content.md

# Update and publish with categories
ruby hatena_blog_updater.rb -i 13574176438046791234 -t "Updated Title" -f content.md \
  -p -c "Ruby,API"

# Preserve publication datetime
ruby hatena_blog_updater.rb -i 13574176438046791234 -t "Updated Title" -f content.md \
  --updated "2024-01-01T12:34:56+09:00"

# Update while preserving existing categories and datetime
ruby hatena_blog_updater.rb -i 13574176438046791234 -t "Updated Title" -f content.md \
  --preserve

API Reference

Hatena Blog AtomPub API

License

MIT License