Skip to main content
skill CX Codex

csdn — Claude Code skill: what it does, how to install

Manages CSDN blog posts and pulls view metrics right inside your coding agent using your own login cookies.

Apache-2.0 184 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill csdn -a claude-code
Open on GitHub

What csdn does

This tool integrates directly with the user's CSDN account on blog.csdn.net using captured session cookies. Everything runs through a standalone Python script located at scripts/csdn.py that relies exclusively on Python stdlib modules like urllib and hmac. It speaks to CSDN web APIs directly and includes browser headers to navigate around the site WAF during reading operations.

Through the CLI, you can query account metadata via whoami, fetch recent posts along with view, like, and comment counts, or retrieve stats for an individual article. When uploading Markdown content, the script automatically uploads external image links to CSDN's internal image host i-blog.csdnimg.cn, preventing hotlink protection blocks during rendering.

Your session token lives in the CSDN_COOKIES environment variable and must be kept secret. Publishing writes directly to your public profile, so dry-run execution is enforced unless you supply the --confirm parameter as the final argument.

What it helps with

  • pull view, comment, and like metrics for published CSDN posts
  • publish Markdown drafts directly to blog.csdn.net
  • upload external Markdown images onto CSDN CDN storage
  • verify active CSDN credentials and account details

Example prompts for the agent

  • Check my CSDN login status and list total post count
  • Fetch the stats for my latest 20 articles on CSDN
  • Publish article.md to CSDN as a draft with tags Python,AI

How to install csdn

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill csdn -a claude-code

2Manually: put the files in place

~/.claude/skills/csdn/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/csdn/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about csdn

How to install csdn in Claude Code?

Run npx skills add AceDataCloud/Skills --skill csdn -a claude-code. The file will be placed in ~/.claude/skills/csdn/SKILL.md.

What does the csdn skill do?

It lets your coding agent read account statistics, inspect article metrics, and publish Markdown drafts or live articles to blog.csdn.net.

Why does the CLI return a WAF 403 error?

A 403 response means your stored session cookies in CSDN_COOKIES have expired. Reconnect your session at studio.acedata.cloud/console/connectors instead of looping retry commands.

Source text

SKILL.md · Apache-2.0
---
name: csdn
description: Read and publish on CSDN (blog.csdn.net) with the user's own login cookies (BYOC) — list their published articles with view/like/comment stats, inspect one article, and publish a new article. Use when the user mentions CSDN, "我的 CSDN 文章", reading their article stats (阅读/点赞), or publishing/发文 to CSDN.
when_to_use: |
  Trigger for anything on the user's CSDN (blog.csdn.net) account driven by
  their own login cookie: show who they are, list their published articles with
  view / like / comment counts, look at one article's stats, or publish a new
  article. This acts as the user's real account, so writes are gated behind an
  explicit confirmation.
connections: [csdn]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

# csdn — read & publish on CSDN via your own cookies

Drives the user's **real** CSDN account through the same web APIs the site's own
editor uses, authenticated by the login cookie they captured with the ACE
extension. No browser, no third-party deps — `urllib` + `hmac` (the editor's
save endpoint requires an HMAC signature, computed with stdlib).

The connector injects the cookie jar as an env var:

- `CSDN_COOKIES` — a JSON array of cookies. **Secret — never echo or print it.**
  The CLI reads it for you.

> CSDN fronts its APIs with a WAF; the CLI already sends a full browser
> fingerprint so reads aren't 403'd. If you still get a WAF 403, the cookie
> expired — have the user reconnect.

## CLI

The skill ships [`scripts/csdn.py`](scripts/csdn.py) — self-contained, stdlib only.

```sh
# $SKILL_DIR can point at another skill loaded this turn — anchor on our own
# script, and re-run this at the top of every Bash block (fresh shell each time).
CSDN="$SKILL_DIR/scripts/csdn.py"; [ -f "$CSDN" ] || CSDN=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/csdn.py' 2>/dev/null | head -1)
[ -f "$CSDN" ] || { echo "csdn script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }
python3 "$CSDN" whoami                     # who is logged in (+ total article count)
python3 "$CSDN" articles --limit 20        # my published articles + stats
python3 "$CSDN" article <article-id>       # one article's stats
```

Stats come straight from CSDN: `view_count` (阅读), `digg_count` (点赞),
`comment_count` (评论), `collect_count` (收藏).

## Verify the connection first

```sh
CSDN="$SKILL_DIR/scripts/csdn.py"; [ -f "$CSDN" ] || CSDN=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/csdn.py' 2>/dev/null | head -1)
python3 "$CSDN" whoami
# → {"username": "...", "nickname": "...", "articles_total": 0}
```

On a WAF 403 / auth error the cookie is expired — tell the user to reconnect at
<https://studio.acedata.cloud/console/connectors>. Do **not** retry in a loop.

## Publishing — GATED (dry-run unless trailing `--confirm`)

`publish` writes to the user's real account. Content is **Markdown**. Without a
trailing `--confirm` it dry-runs. `--confirm` is honored **only as the last
argument**. Always show the dry-run, get an explicit "yes", then re-run with
`--confirm` last.

```sh
CSDN="$SKILL_DIR/scripts/csdn.py"; [ -f "$CSDN" ] || CSDN=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/csdn.py' 2>/dev/null | head -1)
python3 "$CSDN" publish --title "标题" --content-file a.md                      # dry-run
python3 "$CSDN" publish --title "标题" --content-file a.md --draft-only --confirm  # private draft (status=2)
python3 "$CSDN" publish --title "标题" --content-file a.md --tags "AI,Python" --confirm  # PUBLIC, goes live
```

- `--draft-only` saves a private draft (CSDN `status=2`) — safe, nothing public.
- Without `--draft-only` the article is **published publicly** under the user's
  name. Default to `--draft-only` unless the user clearly asked to go live.
- `--tags` is a comma-separated list of article tags.

## Images

`publish` automatically re-hosts external markdown images (`![](url)`) onto
CSDN's own CDN (`i-blog.csdnimg.cn`) before saving — CSDN 防盗链 blocks external
images, and saving an article full of external URLs can even time out. Images
already on `csdnimg.cn` are left alone; pass `--no-rehost-images` to skip. An
image that fails to upload keeps its original URL (never blocks the post).

## Gotchas — surface before the user is surprised

- **This is the user's real CSDN account.** Confirm before any publish.
- **Cookie expiry / WAF 403**: reconnect at studio.acedata.cloud/console/connectors —
  never loop-retry a WAF block.
- The editor save endpoint is signed with an HMAC key baked into CSDN's web
  bundle; if CSDN rotates it, publish fails loudly (reads still work).
- **Never print `CSDN_COOKIES`** — it is full account access.
- **ToS**: cookie automation acts only on the user's own account with their own
  captured cookie; the user owns that risk.


## Record the output

After you successfully publish and obtain the live result URL, call the built-in
`publish_artifact` tool ONCE so the user can track this deliverable in **My Outputs**:

```
publish_artifact(kind="article", channel="csdn", title="<title>", url="<the REAL returned URL>", status="delivered")
```

Use the real returned URL — never fabricate one. Call it once per published item,
only after delivery is confirmed; skip it (or use `status="failed"`) if publishing failed.
See `_shared/artifacts.md`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Marketing and content →

From the same set67

The whole set →
telegram Controls a personal Telegram account via Telethon and MTProto. Helps read unread chats, search history, download media, and send messages directly from the agent. CX Codex +1 189installs google-search-console google-search-console pulls Search Console data through API v1: queries, pages, CTR, average position, sitemaps and index status for a single URL. CX Codex +1 188installs microsoft-excel Reads and edits Excel workbooks that live in OneDrive or SharePoint through the Microsoft Graph workbook API. Needs an OAuth token in $MICROSOFT_EXCEL_TOKEN. CX Codex +1 187installs microsoft-todo Gives the agent a way to read and change Microsoft To Do lists and tasks through Microsoft Graph v1.0, with curl requests parsed by jq. CX Codex +1 187installs discordbot Use your Discord bot to list servers and channels, read recent messages, and post replies. It also supports a single opt-in DM to a user who initiated contact. CX Codex +1 181installs medium Reads Medium articles and engagement stats, and publishes Markdown stories using your own login cookies. Helpful when drafting or tracking posts without opening a browser. CX Codex +1 180installs weibo weibo reads and posts on 微博 through your own login cookie: recent entries with repost, comment and like counts, plus publishing a new one. CX Codex +1 180installs google-sheets This skill reads and edits Google Sheets through the Sheets v4 REST API. Use it for ranges, rows, tabs, and spreadsheet creation from an agent conversation. CX Codex +1 179installs

Project sponsors

Companies that keep this analytics open