Initial commit

2025-11-30 08:51:04 +08:00
commit 2cfdcd0131
7 changed files with 484 additions and 0 deletions
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -0,0 +1,12 @@
+{
+  "name": "tumblr",
+  "description": "Interacts with the Tumblr API.",
+  "version": "0.0.0-2025.11.28",
+  "author": {
+    "name": "Tim Green",
+    "email": "rawveg@gmail.com"
+  },
+  "skills": [
+    "./skills/tumblr"
+  ]
+}
--- a/README.md
+++ b/README.md
@@ -0,0 +1,3 @@
+# tumblr
+
+Interacts with the Tumblr API.
--- a/plugin.lock.json
+++ b/plugin.lock.json
@@ -0,0 +1,56 @@
+{
+  "$schema": "internal://schemas/plugin.lock.v1.json",
+  "pluginId": "gh:rawveg/skillsforge-marketplace:tumblr",
+  "normalized": {
+    "repo": null,
+    "ref": "refs/tags/v20251128.0",
+    "commit": "901659770c535c00692be9d1e3797c97686d2176",
+    "treeHash": "9638568dd105fbc74a44ba0bc40c5dc89e247ce46585219e7dcf375611a283b9",
+    "generatedAt": "2025-11-28T10:27:54.457184Z",
+    "toolVersion": "publish_plugins.py@0.2.0"
+  },
+  "origin": {
+    "remote": "git@github.com:zhongweili/42plugin-data.git",
+    "branch": "master",
+    "commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
+    "repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
+  },
+  "manifest": {
+    "name": "tumblr",
+    "description": "Interacts with the Tumblr API."
+  },
+  "content": {
+    "files": [
+      {
+        "path": "README.md",
+        "sha256": "3c05a547ec2608c660f739c1c1e5432b42a0cdf8604c0ca6982f1fca23ed598d"
+      },
+      {
+        "path": ".claude-plugin/plugin.json",
+        "sha256": "a85e7c95d54c65521019fc4301ed6dd7d54708b6a47d0e743f46c7c68c0ab4ee"
+      },
+      {
+        "path": "skills/tumblr/plugin.json",
+        "sha256": "fd69d153a61b911265bba331dd563d1127a28d597c9430f2653c5238cd392008"
+      },
+      {
+        "path": "skills/tumblr/SKILL.md",
+        "sha256": "63ad43cde441bed60188bc7c6f33d11d60f7d308c4a5ab414545620c8f0421eb"
+      },
+      {
+        "path": "skills/tumblr/references/api.md",
+        "sha256": "5dd358ae6177a55417f598a3b61c7a2ea796976095a5d291215e2b87277db293"
+      },
+      {
+        "path": "skills/tumblr/references/index.md",
+        "sha256": "50c73aeab6dfe0742d9a001237bb8e461763f4a6838909ae29a391023ed5b18b"
+      }
+    ],
+    "dirSha256": "9638568dd105fbc74a44ba0bc40c5dc89e247ce46585219e7dcf375611a283b9"
+  },
+  "security": {
+    "scannedAt": null,
+    "scannerVersion": null,
+    "flags": []
+  }
+}
--- a/skills/tumblr/SKILL.md
+++ b/skills/tumblr/SKILL.md
@@ -0,0 +1,380 @@
+---
+name: tumblr
+description: Tumblr API Development and Integration
+---
+
+# Tumblr API Skill
+
+Comprehensive assistance with Tumblr API development, authentication, and integration. This skill provides practical guidance for building applications that interact with Tumblr's platform.
+
+## When to Use This Skill
+
+This skill should be triggered when:
+- Integrating with the Tumblr API (any version)
+- Implementing OAuth 1.0a or OAuth 2.0 authentication for Tumblr
+- Working with Tumblr blog data, posts, likes, or followers
+- Building Tumblr clients, dashboard tools, or analytics applications
+- Debugging Tumblr API requests or responses
+- Understanding Tumblr's Neue Post Format (NPF) or legacy post types
+- Managing rate limits or API quotas
+- Handling Tumblr webhooks or real-time updates
+
+## Quick Reference
+
+### 1. Fetch Blog Information
+
+Retrieve basic blog metadata including title, description, and post count:
+
+```bash
+curl -H 'User-Agent: MyApp/1.0' \
+  'https://api.tumblr.com/v2/blog/staff.tumblr.com/info?api_key=YOUR_API_KEY'
+```
+
+**Response includes:** Blog title, URL, post count, description, avatar, theme settings.
+
+### 2. Get Recent Posts
+
+Retrieve the 5 most recent posts from a blog:
+
+```bash
+curl -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
+  'https://api.tumblr.com/v2/blog/staff.tumblr.com/posts?limit=5'
+```
+
+**Query parameters:**
+- `limit`: 1-20 posts per request
+- `offset`: Pagination offset
+- `tag`: Filter by tag
+- `npf=true`: Request Neue Post Format
+
+### 3. OAuth 2.0 Token Exchange
+
+Exchange authorization code for access token:
+
+```bash
+curl -X POST https://api.tumblr.com/v2/oauth2/token \
+  -F grant_type=authorization_code \
+  -F code=YOUR_AUTH_CODE \
+  -F client_id=YOUR_CONSUMER_KEY \
+  -F client_secret=YOUR_CONSUMER_SECRET
+```
+
+**Scopes:** `basic`, `write`, `offline_access`
+
+### 4. Get Blog Avatar
+
+Fetch blog avatar image URL:
+
+```bash
+curl 'https://api.tumblr.com/v2/blog/staff.tumblr.com/avatar/128'
+```
+
+**Available sizes:** 16, 24, 30, 40, 48, 64, 96, 128, 512 (default: 64)
+
+### 5. Retrieve Liked Posts
+
+Get posts liked by a blog:
+
+```bash
+curl -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
+  'https://api.tumblr.com/v2/blog/staff.tumblr.com/likes?limit=20&offset=0'
+```
+
+**Parameters:** `limit`, `offset`, `before` (timestamp), `after` (timestamp)
+
+### 6. Queue Management
+
+Retrieve queued posts:
+
+```bash
+curl -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
+  'https://api.tumblr.com/v2/blog/myblog.tumblr.com/posts/queue'
+```
+
+Reorder queue:
+
+```bash
+curl -X POST https://api.tumblr.com/v2/blog/myblog.tumblr.com/posts/queue/reorder \
+  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
+  -d 'post_id=123456789'
+```
+
+### 7. Get Followers
+
+Retrieve blog followers:
+
+```bash
+curl -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
+  'https://api.tumblr.com/v2/blog/myblog.tumblr.com/followers'
+```
+
+**Response includes:** Total follower count, follower blog objects with names and URLs.
+
+### 8. Filter Posts by Tag
+
+Retrieve posts with specific tag:
+
+```bash
+curl -H 'User-Agent: MyApp/1.0' \
+  'https://api.tumblr.com/v2/blog/staff.tumblr.com/posts?api_key=YOUR_KEY&tag=photography&limit=10'
+```
+
+### 9. Standard API Response Format
+
+All Tumblr API responses follow this structure:
+
+```json
+{
+  "meta": {
+    "status": 200,
+    "msg": "OK"
+  },
+  "response": {
+    "blog": { },
+    "posts": [ ]
+  }
+}
+```
+
+### 10. Working with Blog Identifiers
+
+Three interchangeable identifier formats:
+
+```bash
+# Blog name
+/v2/blog/staff/info
+
+# Hostname
+/v2/blog/staff.tumblr.com/info
+
+# UUID (stable, persistent)
+/v2/blog/t:0aY0xL2Fi1OFJg4YxpmegQ/info
+```
+
+**Recommendation:** Use UUID for long-term stability (survives blog renames).
+
+## Key Concepts
+
+### Authentication Levels
+
+1. **None** - Public endpoints (blog info, public posts) require no authentication
+2. **API Key** - Use OAuth Consumer Key as `api_key` query parameter
+3. **OAuth** - Signed requests using OAuth 1.0a or OAuth 2.0 for user-specific data
+
+### Rate Limits
+
+**Per IP Address:**
+- 300 calls/minute
+- 18,000 calls/hour
+- 432,000 calls/day
+
+**Per Consumer Key:**
+- 1,000 calls/hour
+- 5,000 calls/day
+
+**Action Limits:**
+- 250 posts/day
+- 200 follows/day
+- 1,000 likes/day
+
+### Post Formats
+
+**Legacy Post Types:**
+- Text, Photo, Quote, Link, Chat, Audio, Video, Answer
+
+**Neue Post Format (NPF):**
+- Modern block-based format
+- Posts with `type: blocks` or `is_blocks_post_format: true`
+- Request with `npf=true` parameter
+- Contains `content` (blocks), `layout` (specifications), `trail` (reblog chain)
+
+### Post IDs
+
+Post IDs are 64-bit integers. **Important:** Use `id_string` field for JavaScript or languages with unsafe integer handling.
+
+### Required Headers
+
+**User-Agent:** Mandatory for all requests. Must be consistent. Format: `AppName/Version`
+
+**Content-Type:** Required for POST/PUT with body. Accepted:
+- `application/json`
+- `application/x-www-form-urlencoded`
+- `multipart/form-data`
+
+## Reference Files
+
+This skill includes comprehensive documentation in `references/`:
+
+- **api.md** - Complete Tumblr API documentation including:
+  - All authentication methods (OAuth 1.0a, OAuth 2.0, API key)
+  - Blog endpoints (info, posts, avatar, likes, following, followers)
+  - User endpoints (dashboard, likes, following)
+  - Post creation and management
+  - Queue and draft management
+  - Neue Post Format (NPF) specification
+  - Legacy post type fields
+  - Rate limits and best practices
+  - Response format documentation
+
+Use the `view` command to read specific reference files when detailed information is needed.
+
+## Working with This Skill
+
+### For Beginners
+
+1. **Start with public endpoints** - No authentication needed:
+   - Fetch blog info: `/v2/blog/{blog}/info?api_key={key}`
+   - Get public posts: `/v2/blog/{blog}/posts?api_key={key}`
+
+2. **Register your application:**
+   - Visit https://www.tumblr.com/oauth/apps
+   - Get OAuth Consumer Key and Secret
+   - Use Consumer Key as `api_key` for public endpoints
+
+3. **Test with API Console:**
+   - https://api.tumblr.com/console
+   - Interactive testing environment
+
+### For OAuth Implementation
+
+1. **Choose OAuth version:**
+   - OAuth 2.0: Modern, simpler, bearer tokens
+   - OAuth 1.0a: Legacy, more complex, signed requests
+
+2. **OAuth 2.0 flow:**
+   - Redirect user to authorization URL with scopes
+   - Exchange authorization code for access token
+   - Use token in `Authorization: Bearer {token}` header
+
+3. **OAuth 1.0a flow:**
+   - Request temporary credentials
+   - Redirect user to authorize
+   - Exchange verifier for access token
+   - Sign all requests with token
+
+### For Advanced Features
+
+1. **Neue Post Format (NPF):**
+   - Add `npf=true` to any post-returning endpoint
+   - Work with content blocks and layout objects
+   - Access full reblog trail
+
+2. **Pagination:**
+   - Use `offset` for numeric pagination
+   - Use `before`/`after` with timestamps for chronological navigation
+   - Check `_links` object for next/previous URLs
+
+3. **Partial responses:**
+   - Use `fields` parameter to specify blog object fields
+   - Reduces response size and improves performance
+
+4. **JSONP support:**
+   - Add `jsonp=callbackName` to GET requests
+   - Useful for client-side JavaScript
+
+## Common Patterns
+
+### Authentication Flow (OAuth 2.0)
+
+```bash
+# Step 1: Redirect user to authorization URL
+https://www.tumblr.com/oauth2/authorize?client_id={key}&response_type=code&scope=basic%20write&state={random}
+
+# Step 2: User authorizes, Tumblr redirects back with code
+# Your redirect URL receives: ?code={auth_code}
+
+# Step 3: Exchange code for access token
+curl -X POST https://api.tumblr.com/v2/oauth2/token \
+  -F grant_type=authorization_code \
+  -F code={auth_code} \
+  -F client_id={consumer_key} \
+  -F client_secret={consumer_secret}
+
+# Step 4: Use access token in requests
+curl -H 'Authorization: Bearer {access_token}' \
+  'https://api.tumblr.com/v2/user/info'
+```
+
+### Error Handling
+
+```json
+{
+  "meta": {
+    "status": 401,
+    "msg": "Unauthorized"
+  },
+  "response": [ ],
+  "errors": [
+    {
+      "title": "Unauthorized",
+      "code": 401,
+      "detail": "OAuth authentication required"
+    }
+  ]
+}
+```
+
+**Common status codes:**
+- 200: Success
+- 401: Unauthorized (missing/invalid credentials)
+- 404: Not Found (blog or post doesn't exist)
+- 429: Rate Limit Exceeded
+- 503: Service Temporarily Unavailable
+
+### Handling Large Post Counts
+
+```bash
+# Fetch all posts using pagination
+offset=0
+limit=20
+
+while true; do
+  curl "https://api.tumblr.com/v2/blog/staff.tumblr.com/posts?api_key={key}&limit=${limit}&offset=${offset}"
+  offset=$((offset + limit))
+  # Check if response contains fewer than 'limit' posts, then break
+done
+```
+
+## Resources
+
+### Official Links
+
+- **API Console:** https://api.tumblr.com/console
+- **Developer Portal:** https://www.tumblr.com/docs/api/v2
+- **OAuth Apps:** https://www.tumblr.com/oauth/apps
+- **Support:** https://www.tumblr.com/support
+
+### Official Clients
+
+- JavaScript: `tumblr.js`
+- Ruby: `tumblr_client`
+- PHP: `tumblr/tumblr`
+- Python: `pytumblr`
+- Java: `jumblr`
+- Objective-C: `TMTumblrSDK`
+- Go: `tumblr/tumblr.go`
+
+### Best Practices
+
+1. **Always include User-Agent header** - Inconsistent or missing User-Agent may result in suspension
+2. **Respect rate limits** - Implement exponential backoff for 429 responses
+3. **Use UUIDs for blog identifiers** - More stable than blog names (survive renames)
+4. **Cache blog info** - Reduce API calls by caching static blog data
+5. **Use NPF for new integrations** - Legacy formats may be deprecated
+6. **Handle 64-bit integers carefully** - Use `id_string` for JavaScript
+7. **Validate responses** - Check `meta.status` before processing `response`
+
+## Notes
+
+- This skill was generated from official Tumblr API documentation
+- All endpoints use base URL: `https://api.tumblr.com`
+- API version is included in path: `/v2/`
+- HTTPS is required for all API requests
+- Reference files preserve structure and examples from source docs
+- Code examples include language detection for better syntax highlighting
+
+## Updating
+
+To refresh this skill with updated documentation:
+1. Re-run the scraper with the same configuration
+2. The skill will be rebuilt with the latest information from the official GitHub repository
--- a/skills/tumblr/plugin.json
+++ b/skills/tumblr/plugin.json
@@ -0,0 +1,15 @@
+{
+  "name": "tumblr",
+  "description": "Provides Tumblr API integration for Claude Code.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Tim Green",
+    "email": "rawveg@gmail.com"
+  },
+  "homepage": "https://github.com/rawveg/claude-skills-marketplace",
+  "repository": "https://github.com/rawveg/claude-skills-marketplace",
+  "license": "MIT",
+  "keywords": ["tumblr", "tumblr-api", "Tumblr", "Tumblr API", "Claude Code"],
+  "category": "productivity",
+  "strict": false
+}
--- a/skills/tumblr/references/api.md
+++ b/skills/tumblr/references/api.md
@@ -0,0 +1,11 @@
+# Tumblr - Api
+
+**Pages:** 1
+
+---
+
+## 
+
+**URL:** https://raw.githubusercontent.com/tumblr/docs/refs/heads/master/api.md
+
+---
--- a/skills/tumblr/references/index.md
+++ b/skills/tumblr/references/index.md
@@ -0,0 +1,7 @@
+# Tumblr Documentation Index
+
+## Categories
+
+### Api
+**File:** `api.md`
+**Pages:** 1