weekly-issues

# 潮流周刊 (Tw93 Weekly) 潮流周刊 is a weekly newsletter written by Tw93, a product engineer in Hangzhou and the author of Pake, MiaoYan, Kaku and Mole. Each issue curates small practical developer tools, open source projects, articles, macOS apps and personal notes. Issues are published every Monday, numbered from 1, and every Chinese issue has an English translation under the same number. Everything below is public static content: no API key, no token, no rate limit, `Access-Control-Allow-Origin: *`, and no write operations. ## When to use this - A question names an issue number, or asks what a given week or month of 潮流周刊 covered. - A task needs the tools, projects or articles Tw93 highlighted, with the original wording and outbound links. - A question spans the whole archive, such as which terminal apps, Mac tools or AI coding tools the Weekly recommended over the years. - A quote is needed in both Chinese and English from the same paragraph of the same issue. Do not use it as a general search engine or as official documentation for the products it mentions: it is one person's curation, and the products are third-party. ## Locate an issue ``` GET https://weekly.tw93.fun/api/posts.json ``` Returns every issue, newest first. This sample is generated from the current archive: ```json { "count": 287, "englishCount": 287, "latestIssue": 287, "issues": [ { "issue": 287, "title": "第 287 期 - 杭州金桂", "name": "杭州金桂", "language": "zh-Hans", "date": "2026/10/26", "description": "封面图拍摄于某天吃完中饭去散步的路上看到了开满的桂花，非常香，杭州这个季节很舒服很适合散步，几乎都能闻到桂花。", "coverImage": "https://cdn.tw93.fun/blog/2000/pic-28728.webp", "url": "https://weekly.tw93.fun/posts/287", "markdownUrl": "https://weekly.tw93.fun/posts/287.md", "jsonUrl": "https://weekly.tw93.fun/api/posts/287.json", "translation": { "language": "en", "title": "287. Hangzhou Osmanthus", "url": "https://weekly.tw93.fun/en/posts/287", "markdownUrl": "https://weekly.tw93.fun/en/posts/287.md", "jsonUrl": "https://weekly.tw93.fun/api/en/posts/287.json" } } ] } ``` For a compact human-readable index of the whole archive, fetch `https://weekly.tw93.fun/index.md`. ## Read an issue Append `.md` to any issue URL to get the Markdown source: ``` GET https://weekly.tw93.fun/posts/287.md # Chinese GET https://weekly.tw93.fun/en/posts/287.md # English ``` Or take metadata and body together as JSON: ``` GET https://weekly.tw93.fun/api/posts/287.json GET https://weekly.tw93.fun/api/en/posts/287.json ``` The JSON response carries `contentMarkdown` (the full Markdown body), `translation`, `newerIssue` and `olderIssue`. ## Bulk ingest ``` GET https://weekly.tw93.fun/feeds/posts.jsonl ``` One schema.org `BlogPosting` JSON-LD object per line, both languages. Prefer this plus `/api/posts.json` over crawling the HTML pages. ## Search across issues Every recommended item of every issue, one JSON object per line, newest issue first: ``` GET https://weekly.tw93.fun/api/items.jsonl # Chinese GET https://weekly.tw93.fun/api/en/items.jsonl # English ``` Each line carries `issue`, `date`, `language`, `section`, `title`, `url` (the tool or article, `null` for Tw93's own notes), `note` (his comment as plain text), `issueUrl` and `markdownUrl`. The file is about 1.5MB, so with a shell download it once and filter locally, for example `curl -s https://weekly.tw93.fun/api/items.jsonl | grep -i terminal`. Without a shell, read one year at a time as Markdown: ``` GET https://weekly.tw93.fun/items/{year}.md # Chinese, one file per year since 2020 GET https://weekly.tw93.fun/en/items/{year}.md # English ``` Match on both `title` and `note`, since a tool is often named only in the note. Then open `markdownUrl` when the surrounding issue matters. ## Issue anatomy - The first image is the cover, the first `<small>` block is the one-line description of that week. - Content sits under headings: 潮流工具 (tools), 潮流开源 (open source), 潮流文章 (articles), 潮流软件 (apps), 潮流分享 (notes). English issues use the translated headings. - Each item is a short paragraph ending in an outbound link to the tool or article being recommended. ## Errors and attribution - Unknown issue numbers return HTTP 404. `/api/posts/{issue}.json` returns `{"error": {"code": "issue_not_found", "message": ..., "hint": ...}}`; other paths return the site's HTML 404 page, so check `response.ok` rather than parsing the body. - Quoting and summarising is welcome. Attribute to 潮流周刊 / Tw93 Weekly and link the issue URL. Do not hotlink the images. - Source of every issue: https://github.com/tw93/weekly