搜索插件、代码仓与 APP 分类

插件详情v0.4.2

metadata_fetch

一个用于提取网页元数据的 Dart 库,例如 OpenGraph、Meta、Twitter 卡片和结构化数据 (Json-LD)

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
2.9万
喜欢数
106
Pub 分数
150

安装插件

flutter pub add metadata_fetch

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个用于从网页中提取元数据的 Dart 库,包括 OpenGraph、标准 meta 标签、Twitter Cards 和 JSON-LD 结构化数据。它使应用程序能够程序化地获取丰富的内容信息,如标题、描述、图片和其他关键细节。非常适合需要动态预览或显示网页内容的应用程序,例如社交媒体集成器、新闻阅读器或链接分享工具。该库支持多个平台,确保在 Android、iOS、Web、macOS、Windows 和 Linux 上行为一致。

适合场景

  • 网页预览生成
  • 社交媒体链接分享
  • 新闻应用的内容抓取
  • 应用程序中的动态元数据显示
  • URL分析用于SEO工具

主要特点

  • 支持 OpenGraph、Twitter Cards 和 JSON-LD
  • 提取标题、描述、图像和自定义元数据
  • 跨平台兼容性
  • 用于获取和解析的简单 API
  • 对格式错误的 HTML 的稳健处理

适合对象

  • 需要丰富链接预览的应用
  • 开发内容聚合器的开发者
  • 用于URL元数据分析的工具
  • 跨平台网络爬虫

使用建议

  • 需要网络访问以获取远程页面
  • 在具有反爬虫措施的网站上可能失败
  • 依赖于准确的 HTML 结构
  • 不适用于无速率限制的高频率抓取
  • 解析可能因非标准标记而异

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Metadata Fetch

A dart library for extracting metadata in web pages. Supports OpenGraph, Meta, Twitter Cards, and Structured Data (Json-LD)

Available on Pub Dev: Pub

Metadata Structure

Metadata:
  - title
  - description
  - image
  - url

Usage

Extract Metadata for a given URL
import 'package:metadata_fetch/metadata_fetch.dart';

main() async {
  final myURL = 'https://flutter.dev';

  // Use the `MetadataFetch.extract()` function to fetch data from the url
  var data = await MetadataFetch.extract(myURL); 

  print(data.title) // Flutter - Beautiful native apps in record time

  print(data.description) // Flutter is Google's UI toolkit for crafting beautiful...

  print(data.image) // https://flutter.dev/images/flutter-logo-sharing.png

  print(data.url) // https://flutter.dev/

  var dataAsMap = data.toMap();


}
Parsing Manually
Get aggregated Metadata from a document

This method prioritizes Open Graph data, followed by Twitter Card, JSON-LD and finally falls back to HTML metadata.

import 'package:metadata_fetch/metadata_fetch.dart';
import 'package:http/http.dart' as http;

void main () async {

  final myURL = 'https://flutter.dev';

  // makes a call
  var response = await http.get(myURL);

  // Convert Response to a Document. The utility function `MetadataFetch.responseToDocument` is provided or you can use own decoder/parser.
  var document = MetadataFetch.responseToDocument(response);


  // get aggregated metadata
  var data = MetadataParser.parse(document);
  print(data);


}

Manually specify which Metadata parser to use
import 'package:metadata_fetch/metadata_fetch.dart';
import 'package:http/http.dart' as http;

void main () async {

  final myURL = 'https://flutter.dev';

  // Makes a call
  var response = await http.get(myURL);

  // Convert Response to a Document. The utility function `responseToDocument` is provided or you can use own decoder/parser.
  var document = responseToDocument(response);


  // Get OpenGraph Metadata
  var ogData = MetadataParser.OpenGraph(document);
  print(ogData);

  // Get Html metadata
  var htmlData = MetadataParser.HtmlMeta(document);
  print(htmlData);

  // Get Structured Data
  var structuredData = MetadataParser.JsonLdSchema(document);
  print(structuredData);

  // Get Twitter Cards Data
  var  twitterCardData = MetadataParser.TwitterCard(document);
  print(twitterCardData);

}
Provide a fallback url when manually parsing

If the parsers cannot extract a URL from the document, you may optionally provide a URL in MetadataFetch.parse().

This URL will be added in the final Metadata structure, and is used to resolve images with relative URLs (non-absolute URLs).

import 'package:metadata_fetch/metadata_fetch.dart';
import 'package:http/http.dart' as http;

void main () async {

  final myURL = 'https://flutter.dev';

  // makes a call
  var response = await http.get(myURL);

  // Convert Response to a Document. The utility function `MetadataFetch.responseToDocument` is provided or you can use own decoder/parser.
  var document = MetadataFetch.responseToDocument(response);


  // get aggregated metadata, supplying a fallback URL
  // Used for images with relative URLs
  var data = MetadataParser.parse(document, url:myURL);
  print(data);

}

Credit

This library is inspired by open_graph_parser. However this one tries to be more general.

Roadmap

  • Weighted or Preferred Metadata. Can assign custom weights for each parser to provide a fallback priority sytem
  • Improve Documentation

Questions, Bugs, and Feature Requests

Please forward all queries about this project to the issue tracker.

所属分类

依赖

依赖清单 3 项

源码仓库

使用此插件的项目