OpenGraphReader

SwiftPM compatible Tests License

OpenGraphReader 是一个 Swift 库,可以帮助您轻松地从 HTML 内容中提取 OpenGraph 元数据。OpenGraph 元数据在社交媒体平台上分享时,提供了关于网页内容的结构化信息。

功能特性

安装

通过 Swift Package Manager (SPM) 安装

您可以使用 Swift Package Manager 轻松地将 OpenGraphReader 集成到您的项目中

  1. 打开您的 Xcode 项目。
  2. 点击 “File” > “Swift Packages” > “Add Package Dependency...”
  3. 输入此仓库的 URL:https://github.com/pzmudzinski/OpenGraphReader.git
  4. 选择 “Up To Next Major Version”: 1.0.0
  5. 点击 “Add Package”

用法

获取 OpenGraph 元数据

要从 URL 获取和解析 OpenGraph 元数据

import OpenGraphReader

let reader = OpenGraphReader()
do {
    let openGraphResponse = try await reader.fetch(url: .init(string: "https://www.imdb.com/title/tt15398776/?ref_=ext_shr_lnk"))
    // Access OpenGraph properties using openGraphResponse properties
    print("Title: \(openGraphResponse.title ?? "")")
    print("Description: \(openGraphResponse.description ?? "")")
    // ...
} catch {
    print("Error: \(error)")
}

直接使用 HTML

如果您已经有 HTML,也可以将其传递给 reader

let response = try reader.parse(html: "...")

获取非默认的 meta 标签

如果 OpenGraphResponse 没有您需要的所有属性,您可以使用以下辅助方法之一直接访问所有 meta 标签(包括那些不属于 OpenGraph 规范的标签)

response.stringValue("twitter:image")
response.arrayValue("twitter:tag")
response.doubleValue("twitter:image:height")
response.urlValue("twitter:image:url")

系统要求

贡献

欢迎为 OpenGraphReader 做出贡献! 欢迎提交 issue 或 pull request 以改进或修复 bug。

许可证

OpenGraphReader 基于 MIT 许可证发布。有关更多信息,请参阅 LICENSE 文件。