Cubox 部分网页接口

Cubox 用剪藏网页很方便,但是在电脑上因为懒得打开网页一个个找需要导出、继续阅读的内容,所以一直想整一个获取卡片列表的功能。不过等官方的 API 等了半年也没个影子,不如自己动手,丰衣足食。

登录 Cubox 网站后,在控制台输入 document.cookie,获取 Cookie

image.png

找到获取页面卡片列表的请求

image.png

注意到请求头需要 Cookie 验证

image.png

测试一下可以成功拿到数据

image.png

注意:请求头必须有 authorization,否则会报错

image.png

部分接口整理

所有接口请求头都需要添加 authorization 进行校验

获取卡片列表

请求类型:GET 请求

默认链接URL + ?asc=false&page=1&filters=&archiving=false

参数说明

  • asc:按创建时间日期排序,从旧到新
  • page:页码(一页最多 49 个)
  • filters:不清楚具体用途
  • starTarget:搜索星标内容(默认不加这个参数)
  • archiving:是否在归档内容中搜索,是的话将会返回归档内容的列表,不含未归档的网页

URL 说明

标签

添加标签

请求类型:POST 请求

请求链接https://cubox.pro/c/api/v3/search_engine/update

请求头

添加 content-typeapplication/x-www-form-urlencoded

请求体

userSearchEngineID=卡片的ID&linkedTagNames=[{"name":"标签的名字"}]

返回值

{
  "message": "",
  "code": 200,
  "data": {
    "userSearchEngineID": "ff808081842cc4c1018454d193d735d1",
    "title": "标题",
    "description": "简述",
    "targetURL": "原文链接",
    "resourceURL": null,
    "homeURL": "mp.weixin.qq.com",
    "archiveName": "archive/1667870336862/595265.html",
    "content": "剪藏内容 HTML",
    "articleName": "3repjS",
    "articleWordCount": 2151,
    "byline": "文章作者",
    "cover": "surface/2022110809185127032/14815.jpg",
    "articleURL": null,
    "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
    "archiving": false,
    "starTarget": null,
    "hasMark": false,
    "isRead": false,
    "markCount": 0,
    "tags": [
      {
        "tagID": "ff8080818479358001847b60518921b1",
        "name": "标签名",
        "rank": 5,
        "updateTime": "2022-11-15T21:03:56:023+08:00",
        "parentId": null
      }
    ],
    "allTags": [
      {
        "tagID": "ff8080818479358001847b60518921b1",
        "name": "标签名",
        "rank": 5,
        "createTime": "2022-11-15T21:00:20:740+08:00",
        "updateTime": "2022-11-15T21:00:20:740+08:00",
        "state": 1,
        "bookmarkCount": null,
        "parentId": null
      }
    ],
    "marks": [],
    "groupId": "ff8080817e05ac27017e06c64fed0def",
    "groupName": "",
    "createTime": "2022-11-08T09:18:51:470+08:00",
    "updateTime": "2022-11-15T21:03:56:023+08:00",
    "status": "Updated",
    "finished": true,
    "inBlackOrWhiteList": false,
    "type": 0
  }
}

注意

这个请求发送的标签会覆盖原有标签

可以使用未创建的标签

新建标签

请求类型:POST 请求

请求链接https://cubox.pro/c/api/v2/tag/new

请求头

添加 content-typeapplication/x-www-form-urlencoded

请求体

linkedName=标签名

返回值

{
  "message": "",
  "code": 200,
  "data": [
    {
      "tagID": "ff8080818479358001847b60518921b1",
      "name": "标签6",
      "rank": 5,	# 第六个标签
      "createTime": "2022-11-15T21:00:20:740+08:00",
      "updateTime": "2022-11-15T21:00:20:740+08:00",
      "state": 1,
      "bookmarkCount": null,
      "parentId": null
    }
  ]
}

获取卡片

获取卡片信息

请求类型:POST 请求

请求链接https://cubox.pro/c/api/search_engine/visit/卡片 ID

请求体:无请求体

返回值

{
  "message": "",
  "code": 200,
  "data": {
    "userSearchEngineID": "ff80808184793cdd01847b3e6be1422e",
    "title": "标题",
    "description": "简述",
    "targetURL": "原文链接",
    "resourceURL": null,
    "homeURL": "mp.weixin.qq.com",
    "archiveName": "archive/1668515023709/243525.html",
    "content": "剪藏内容 HTML",
    "articleName": "unAYy3",
    "articleWordCount": 2587,
    "byline": "原文作者",
    "cover": "surface/2022111520231896973/70906.jpg",
    "articleURL": null,
    "littleIcon": "http://mp.weixin.qq.com/favicon.ico",
    "archiving": false,
    "starTarget": null,
    "hasMark": false,
    "isRead": true,
    "markCount": 0,
    "tags": [
      {
        "tagID": "ff808081847930d401847b52dcaf5bc1",
        "name": "标签名",
        "rank": 3,
        "updateTime": "2022-11-15T21:07:59:033+08:00",
        "parentId": null
      }
    ],
    "allTags": [],
    "marks": [],
    "groupId": "ff8080817e05ac27017e06c64fed0def",
    "groupName": "",
    "createTime": "2022-11-15T20:23:18:937+08:00",
    "updateTime": "2022-11-15T21:07:59:033+08:00",
    "status": "Updated",
    "finished": true,
    "inBlackOrWhiteList": false,
    "type": 0
  }
}

获取卡片原文

请求类型:GET 请求

请求链接https://cubox.pro/c/api/bookmark/content?bookmarkId=卡片 ID

返回值

{
  "message": "",
  "code": 200,
  "data": {
    "marks": null,
    "content": "剪藏内容 HTML"
  }
}

虽然只整理了一小部分网页请求,但是用来自动导出剪藏网页基本是够用的了,总算不用自己一个个点了,哈哈 😋

1 操作
mdzz2048 在 2022-11-15 23:01:03 更新了该帖

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...
  • yumenawei
    支持者 订阅者

    感谢分享~

  • kobi
    订阅者

    惊喜呀,如果 flomo 的旧版彻底下线了,就可以使用 cubox 的速记这个来替代 flomo(新版 flomo 添加了 sign,不能直接请求数据),到时再来写个动作自动将 cubox 速记导入思源 daily note。