GNE v0.1 正式发布： 4 行代码开发新闻网站通用爬虫

GNE（GeneralNewsExtractor）是一个通用新闻网站正文抽取模块，输入一篇新闻网页的 HTML， 输出正文内容、标题、做者、发布时间、正文中的图片地址和正文所在的标签源代码。GNE在提取今日头条、网易新闻、游民星空、 观察者网、凤凰网、腾讯新闻、ReadHub、新浪新闻等数百个中文新闻网站上效果很是出色，几乎可以达到100%的准确率。

使用方式很是简单：

from gne import GeneralNewsExtractor

extractor = GeneralNewsExtractor()
html = '网站源代码'
result = extractor.extract(html)
print(result)
复制代码

GNE 的输入是通过 js 渲染之后的 HTML 代码，因此 GNE 能够配合Selenium 或者 Pyppeteer 使用。

下图是 GNE 配合 Selenium 实现的一个 Demo：

对应的代码为：

import time
from gne import GeneralNewsExtractor
from selenium.webdriver import Chrome


driver = Chrome('./chromedriver')
driver.get('https://www.toutiao.com/a6766986211736158727/')
time.sleep(3)
extractor = GeneralNewsExtractor()
result = extractor.extract(driver.page_source)
print(result)
复制代码

下图是 GNE 配合 Pyppeteer 实现的 Demo：

对应代码以下：

import asyncio
from gne import GeneralNewsExtractor
from pyppeteer import launch

async def main():
    browser = await launch(executablePath='/Applications/Google Chrome.app/Contents/MacOS/Google Chrome')
    page = await browser.newPage()
    await page.goto('https://news.163.com/20/0101/17/F1QS286R000187R2.html')
    extractor = GeneralNewsExtractor()
    result = extractor.extract(await page.content())
    print(result)
    input('检查完成之后回到这里按下任意键')

asyncio.run(main())
复制代码

如何安装 GNE

如今你能够直接使用 pip 安装 GNE 了：

pip install gne
复制代码

若是访问pypi 官方源太慢，你也能够使用网易源：

pip install gne -i https://mirrors.163.com/pypi/simple/
复制代码

安装过程以下图所示：

功能特性

获取正文源代码

在extract()方法只传入网页源代码，不添加任何额外参数时，GNE 返回以下字段：

• title：新闻标题
• publish_time：新闻发布时间
• author：新闻做者
• content：新闻正文
• images: 正文中的图片（相对路径或者绝对路径）

可能有些朋友但愿获取新闻正文所在标签的源代码，此时能够给extract()方法传入with_body_html参数，设置为 True：

extractor = GeneralNewsExtractor()
extractor.extract(html, with_body_html=True)
复制代码

返回数据中将会增长一个字段body_html，它的值就是正文对应的 HTML 源代码。

运行效果以下图所示：

老是返回图片的绝对路径

默认状况下，若是新闻中的图片使用的是相对路径，那么 GNE 返回的images字段对应的值也是图片相对路径的列表。

若是你想始终让 GNE 返回绝对路径，那么你能够给extract()方法增长host参数，这个参数的值是图片的域名，例如：

extractor = GeneralNewsExtractor()
extractor.extract(html, host='https://www.kingname.info')
复制代码

这样，若是新闻中的图片是/images/pic.png，那么 GNE 返回时会自动把它变为https://www.kingname.info/images/pic.png。

指定新闻标题所在的 XPath

GNE 预约义了一组 XPath 和正则表达式用于提取新闻的标题。但某些特殊的新闻网站可能没法提取标题，此时，你能够给extract()方法指定title_xpath参数，用于提取新闻标题：

extractor = GeneralNewsExtractor()
extractor.extract(html, title_xpath='//title/text()')
复制代码

提早移除噪声标签

某些新闻下面可能会存在长篇大论的评论，这些评论看起来比新闻正文“更像”正文，为了防止他们干扰新闻的提取，能够经过给extract()方法传入noise_node_list参数，提早把这些噪声节点移除。noise_node_list的值是一个列表，里面是一个或多个 XPath：

extractor = GeneralNewsExtractor()
extractor.extract(html, noise_node_list=['//div[@class="comment-list"]', '//*[@style="display:none"]'])
复制代码

使用配置文件

API 中的参数 title_xpath、 host、 noise_node_list、 with_body_html除了直接写到 extract() 方法中外，还能够经过一个配置文件来设置。

请在项目的根目录建立一个文件 .gne，配置文件能够用 YAML 格式，也能够使用 JSON 格式。

• YAML 格式配置文件

title:
 xpath: //title/text()
host: https://www.xxx.com
noise_node_list:
 - //div[@class=\"comment-list\"]
 - //*[@style=\"display:none\"]
with_body_html: true
复制代码

• JSON 格式配置文件

{
   "title": {
       "xpath": "//title/text()"
   },
   "host": "https://www.xxx.com",
   "noise_node_list": ["//div[@class=\"comment-list\"]",
                       "//*[@style=\"display:none\"]"],
   "with_body_html": true
}
复制代码

这两种写法是彻底等价的。

配置文件与 extract() 方法的参数同样，并非全部字段都须要提供。你能够组合填写你须要的字段。

若是一个参数，既在 extract() 方法中，又在 .gne 配置文件中，但值不同，那么 extract() 方法中的这个参数的优先级更高。

FAQ

GeneralNewsExtractor(如下简称GNE)是爬虫吗？

GNE不是爬虫，它的项目名称General News Extractor表示通用新闻抽取器。它的输入是HTML，输出是一个包含新闻标题，新闻正文，做者，发布时间的字典。你须要自行设法获取目标网页的HTML。

GNE 如今不会，未来也不会提供请求网页的功能。

GNE支持翻页吗？

GNE不支持翻页。由于GNE不会提供网页请求的功能，因此你须要自行获取每一页的HTML，并分别传递给GNE。

GNE支持哪些版本的Python？

不小于Python 3.6.0

我用requests/Scrapy获取的HTML传入GNE，为何不能提取正文？

GNE是基于HTML来提取正文的，因此传入的HTML必定要是通过JavaScript渲染之后的HTML。而requests和Scrapy获取的只是JavaScript渲染以前的源代码，因此没法正确提取。

另外，有一些网页，例现在日头条，它的新闻正文其实是以JSON格式直接写在网页源代码的，当页面在浏览器上面打开的时候，JavaScript把源代码里面的正文解析为HTML。这种状况下，你在Chrome上面就看不到Ajax请求。

因此建议你使用Puppeteer/Pyppeteer/Selenium之类的工具获取通过渲染的HTML再传入GNE。

GNE 支持非新闻类网站吗（例如博客、论坛……）

不支持。

关于 GNE

GNE 官方文档：generalnewsextractor.readthedocs.io/

GNE 的项目源代码在：github.com/kingname/Ge…。

关于做者