Skip to content
This repository has been archived by the owner on Jan 23, 2023. It is now read-only.

chocolatl/eh-parser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

解析e-hentai与exhentai各个页面的元数据

使用

npm install eh-parser --save

浏览器

EHParser通过解析DOM对象的文档节点获取数据,假设现在处于E站搜索结果页面,可以插入以下代码获取搜索数据:

  const EHParser = require('eh-parser');
  const data = EHParser.parseSearchPage(document);
  console.log(data);

也可以通过DOMParser API来获取其它页面的DOM对象:

  fetch('https://exhentai.org/g/1183625/18725a8da6', {
    credentials: 'same-origin'    // 发送cookie
  })
  .then(res => res.text())
  .then(html => {
    const document = new DOMParser().parseFromString(html, 'text/html');
    const data = EHParser.parseGalleryPage(document);
    console.log(data);
  });

Node.js

在Node环境中,需要使用jsdom或类似的库获取DOM对象的文档节点

  const JSDOM = require('jsdom').JSDOM;
  const EHParser = require('eh-parser');

  const document = new JSDOM(/* E站搜索结果页面的HTML文本 */).window.document;
  const data = EHParser.parseGalleryPage(document);
  console.log(data);

API

EHParser.parseSearchPage(document, noPaging?)

解析搜索结果页面数据,如:https://exhentai.org

返回结果示例:

{
  "mode": "Minimal+",   // Minimal, Minimal+, Compact, Extended, Thumbnail 之一,获取失败时为Unknown
  "curPage": 0,         // 当前页码,页码从0开始
  "maxPage": 25310,     // 最大页码,页码从0开始
  "prev": null,         // 搜索结果的上一页链接
  "next": "https://exhentai.org/?page=1",   // 搜索结果的下一页链接
  "results": [          // 当前页面的搜索结果
    {
      "title": "(C94) [あめうさぎ (飴玉コン)] CONFITURE (ご注文はうさぎですか?) [中国翻訳]",
      "posted": "2018-11-25 15:17",
      "url": "https://exhentai.org/g/1319745/713400a20b/",
      "cover": "https://exhentai.org/t/60/8f/608f41dd673776c1a47c0ca70275f98342c6884f-2697059-2116-3000-jpg_l.jpg",
      "category": "Doujinshi",
      "rating": 4.5,     // 评分精度为0.5
      "uploader": "BlossomPlus" ,   // 该字段在Thumbnail模式下为空字符串
      "favorite": {           // 收藏信息,如果没有收藏该画廊则为null
        dir: 0,               // 收藏夹序号 0-9
        name: "Favorites 0"   // 收藏夹名
      }
    },
    // ...
  ]
}

解析/favorites页面会得到一个额外的favoritesInfo字段,包含以下内容:

{
  "order": "favorited",      // 排序方式:favorited或posted
  "dirs": [
    {
      "num": 49,             // 收藏数
      "name": "Favorites 0"  // 收藏夹名
    },
    {
      "num": 0,
      "name": "Favorites 1"
    }
  ],
  "current": -1              // 当前显示的收藏夹,对应dirs数组的序号,-1表示Show All Favorites
}

如果noPaing参数传入true,那么返回对象中将仅包含moderesults字段。该选项用于获取无分页器的搜索页面,如/popular

EHParser.parseGalleryPage(document)

解析画廊页面数据,如:https://exhentai.org/g/1183625/18725a8da6

返回结果示例:

{
  "curPage": 0,     // 当前页码,页码从0开始
  "maxPage": 9,     // 最大页码,页码从0开始
  "metaData": {
    "ntitle": "さざなみみぉ pixiv作品合集",
    "jtitle": "",
    "cover": "https://ehgt.org/t/05/1c/051cedd0089ebce224b14ccc98ba89d67ff3f284-954244-800-1119-jpg_250.jpg",
    "category": "Non-H",
    "uploader": "囧途末路",
    "posted": "2018-02-11 13:05",
    "parent": "https://exhentai.org/g/1161712/7d773196aa/",
    "visible": "No (Replaced)",
    "language": "Japanese",
    "fileSize": "182.2 MB",
    "length": "195 pages",
    "favorite": {           // 收藏信息,如果没有收藏该画廊则为null
      dir: 0,               // 收藏夹序号 0-9
      name: "Favorites 0"   // 收藏夹名
    },
    "favorited": "368 times",
    "ratingCount": 76,      // 评分人数
    "rating": 4.53,         // 平均评分
    "myRating": null,       // 我的评分
    "tags": [
      {
        "namespace": "parody",
        "tags": [
          {
            name: "touhou project",   // 标签名
            power: "100+",            // 1+、10+、100+ 详见:https://ehwiki.org/wiki/Tagging_Mechanics#Tag_Mod_Power
            state: "normal"           // normal、upvoted、downvoted、other 详见:https://ehwiki.org/wiki/Tagging_Mechanics#Tag_Colors
          },
          // ...
        ]
      },
      // ...
    ]
  },
  "newerVersions": [
    {
      "url": "https://exhentai.org/g/1205262/5bc2e2c3a6/",
      "title": "さざなみみぉ pixiv作品合集(不定期更新)",
      "posted": "2018-03-31 04:49"
    },
    {
      "url": "https://exhentai.org/g/1230782/a41bc04e18/",
      "title": "さざなみみぉ pixiv作品合集(不定期更新)",
      "posted": "2018-05-27 05:09"
    },
    // ...
  ],
  "uploaderComment": {
    "posted": "11 February 2018, 13:05",
    "author": "囧途末路",
    "content": "P站著名妖梦控画师的P站作品合集,按从早到晚顺序排列"
  },
  "comments": [
    {
      "posted": "30 December 2017, 07:12",
      "author": "536753924",
      "content": "画师没有好坏之分,但是さざなみみぉ,你的妖梦最可爱啦!",
      "score": "+41"
    },
    {
      "posted": "30 December 2017, 07:42",
      "author": "HamburgerHelper",
      "content": "Youmu is love.",
      "score": "+11"
    },
    // ...
  ],
  "imageList": {
    "mode": "large",        // mode为"normal"或"large",与账号设置有关
    "list": [
      {
        "url": "https://exhentai.org/s/051cedd008/1183625-1",
        "thumb": "https://ehgt.org/05/1c/051cedd0089ebce224b14ccc98ba89d67ff3f284-954244-800-1119-jpg_l.jpg",
        "fileName": "001.jpg"
      },
      {
        "url": "https://exhentai.org/s/11286cf784/1183625-2",
        "thumb": "https://ehgt.org/11/28/11286cf7840f1726cdda95f619aaacd7d5a1f9fex1190142-800-1125-jpg_l.jpg",
        "fileName": "002.jpg"
      },
      // ...
    ]
  },
  "apiInfo": {
    "url": "https://exhentai.org/api.php",
    "gid": 1183625,
    "token": "18725a8da6",
    "apiuid": 0,
    "apikey": ""
  }
}

模式为normal时的imageList字段:

{
  "mode": "normal",
  "list": [
    {
      "sprites": "https://exhentai.org/m/001183/1183625-00.jpg",   // CSS Sprites,通过w、h、x、y可以计算出缩略图位置
      "w": "100px",
      "h": "140px",
      "x": "0px",
      "y": "0px",
      "url": "https://exhentai.org/s/051cedd008/1183625-1",
      "fileName": "001.jpg"
    },
    // ...
  ]

文件大小等字段与网页显示结果一致,意味着不是一个精确的数值,如果需要精确的数值可以调用官方API获取

EHParser.parsePicturePage(document)

解析图片页面数据,如:https://exhentai.org/s/594b7edc82/1183625-31

返回结果示例:

{
  "image": "http://144.197.142.91:8484/h/647afa68f7a97d990f360262f0e3bab872fbd501-216944-900-900-jpg/keystamp=1543465500-a9c0673140;fileindex=24684240;xres=2400/Masterpiece.jpg",
  "original": "https://exhentai.org/fullimg.php?gid=1316052&page=3&key=0cz2qum96tg",    // 原图下载链接,不存在时为null
  "next": "https://exhentai.org/s/eeda3df9cf/1316052-4",                                // 下一张图片的页面,最后一张时为null
  "curPage": 4,     // 当前页码,页码从1开始
  "maxPage": 220,   // 最大页码,页码从1开始
  "reloadCode": "23626-428740",
  "fileName": "Masterpiece.jpg"
}

reloadCode字段用于生成页面中Click here if the image fails loading的链接:

  const imagePageURL = 'https://exhentai.org/s/594b7edc82/1183625-31';
  const reloadURL    = imagePageURL + (imagePageURL.indexOf('?') > -1 ? '&' : '?') + 'nl=' + reloadCode;

许可证

GLWT(祝你好运)公共许可证
版权所有(C)每个人,除了作者

任何人都被允许复制、分发、修改、合并、销售、出版、再授权或
任何其它操作,但风险自负。

作者对这个项目中的代码一无所知。
代码处于可用或不可用状态,没有第三种情况。


                祝你好运公共许可证
            复制、分发和修改的条款和条件

0:在不导致作者被指责或承担责任的情况下,你可以做任何你想
要做的事情。

无论是在合同行为、侵权行为或其它因使用本软件产生的情形,作
者不对任何索赔、损害承担责任。

祝你好运及一帆风顺

About

解析E站各个页面的元数据

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published