Publishing To Cnblogs

Publishing to 博客园 (cnblogs)

Overview

Reliably publish a Markdown article to 博客园, or cross-post one from another platform (51cto, etc.). The browser is used only to log in and (optionally) scrape; the actual publish goes through cnblogs' own REST API, which is far more robust than driving the editor with selenium send_keys.

Core principle: Re-host every image on cnblogs' own CDN, and publish via the API with isMarkdown: true. Hotlinked source images break (anti-leech) and the 2024-era send_keys tool rots as the editor DOM changes.

When to Use

• Cross-posting an already-published article (e.g. on 51cto) to 博客园
• Publishing a local .md (with front matter) to 博客园
• Symptoms: images on the published post show 只有链接/裂图, markdown renders as raw text, or a browser-automation publisher fails on missing selectors

Not for: other platforms (CSDN/掘金/知乎…). This skill is cnblogs-specific.

One-Time Setup

1. Install deps: pip install selenium requests markdownify pyyaml (Chrome required; selenium>=4.6 auto-fetches the matching chromedriver — else set CHROMEDRIVER env var).
2. Launch an isolated debug Chrome (coexists with the user's normal Chrome — own profile, no need to close anything):

   chrome --remote-debugging-port=9222 --user-data-dir=/tmp/cnblogs-debug --no-first-run
   

   (Windows: "C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir=%TEMP%\cnblogs-debug)
3. Ask the user to log into 博客园 in that window (https://i.cnblogs.com). Confirm the DevTools endpoint: curl http://127.0.0.1:9222/json/version.

The Pattern

Run scripts from scripts/. Steps 1–2 only for scraping; skip to 3 if you already have a local .md.

1. Scrape a source article → markdown: python scrape.py --url <URL> --out article.md
2. Clean page noise (review the result!): python clean.py --md article.md --cut-before '!\[' --cut-after '\*\*赞\*\*'
3. Get cookies: python get_cookies.py --out cookies.json
4. Re-host images (critical): python rehost_images.py --md article.md --cookies cookies.json
5. Grid layout for multi-image rows (optional): python to_html_rows.py --md article.md
6. Publish:
   • new: python publish.py --md article.md --cookies cookies.json
   • update existing: python publish.py --md article.md --cookies cookies.json --post-id <id>
7. Verify: open the returned URL, scroll, confirm images load. Don't trust naturalWidth=0 in a background tab — that's lazy-load, not a broken image (see references/gotchas.md).

Front matter drives title and tags:

---
title: "文章标题"
tags:
  - 前端
  - claude
---

Quick Reference

API details: references/cnblogs-api.md. Pitfalls: references/gotchas.md.

Common Mistakes

Verification

1. publish.py prints the post url and id.
2. Open the url in a real browser, scroll top→bottom; every image loads.
3. Spot-check: curl -I <cnblogs-image-url> → 200 (referer-independent).
4. Post body renders (headings/code), images are <img> not literal ![...].