goolabs · PyPI · Python 包索引

Goo labs Python API客户端。并提供一些命令行工具。

这些详情尚未由PyPI验证

项目链接

主页

项目描述

Goo labs Python API客户端。并提供一些命令行工具。

功能

提供Goo labs API的API客户端。
提供一些命令行工具。

必需

为了使用此库，您需要在Goo labs网站上获取应用ID。

设置

使用pip创建环境

$ pip install goolabs

对于Max OS X用户。如果您只想使用命令行工具，您可以从homebrew安装。

$ brew install goolabs

使用

morph

日语的形态分析。

另请参阅 https://labs.goo.ne.jp/api/2015/1302/

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
sample_response = api.morph(sentence=u"日本語を分析します。")

# All the arguments of this func.
api.morph(
       request_id="morph-req001",
       sentence=u"日本語を分析します。",
       info_filter="form|pos|read",
       pos_filter=u"名詞|格助詞|動詞活用語尾|動詞接尾辞|句点",
       )

# Possible parts of speech, please refer to the following URL.
# https://labs.goo.ne.jp/api/2015/1158/

示例响应。

{
  "word_list": [
    [
      [ "日本語", "名詞", "ニホンゴ" ],
      [ "を", "格助詞", "ヲ" ],
      [ "分析", "名詞", "ブンセキ" ],
      [ "し", "動詞活用語尾", "シ" ],
      [ "ます", "動詞接尾辞", "マス" ],
      [ "。", "句点", "＄" ]
    ]
  ],
  "request_id": "labs.goo.ne.jp\t1419262824\t0"
}

similarity

对两个单词的相似度进行评分。

另请参阅 https://labs.goo.ne.jp/api/2015/1295/

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.similarity(query_pair=["windows", u"ウィンドウズ"])

# All the arguments of this func.
api.similarity(
       request_id="similarity-req001",
       query_pair=["windows", u"ウィンドウズ"]
       )

示例响应。

{
  "score": 0.7679829666474438,
  "request_id": "labs.goo.ne.jp\t1419263621\t0"
}

hiragana

将日语转换为平假名或片假名。

另请参阅 https://labs.goo.ne.jp/api/2015/1293/

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.hiragana(sentence=u"漢字が混ざっている文章", output_type="hiragana")

# All the arguments of this func.
api.hiragana(
       request_id="hiragana-req001",
       sentence=u"漢字が混ざっている文章",
       output_type="hiragana" # hiragana or katakana
       )

示例响应。

{
  "output_type": "hiragana",
  "converted": "かんじが まざっている ぶんしょう",
  "request_id": "labs.goo.ne.jp\t1419263773\t0"
}

entitiy

从句子中提取唯一的表示。

另请参阅 https://labs.goo.ne.jp/api/2015/1299/.

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.entity(sentence=u"鈴木さんがきょうの9時30分に横浜に行きます。")

# All the arguments of this func.
api.entity(
       request_id="entity-req001",
       sentence=u"鈴木さんがきょうの9時30分に横浜に行きます。"
       class_filter=u"ART|ORG|PSN|LOC|DAT|TIM"
       )

示例响应。

{
  "ne_list": [
    [ "鈴木", "PSN" ],
    [ "きょう", "DAT" ],
    [ "9時30分", "TIM" ],
    [ "横浜", "LOC" ]
  ],
  "request_id": "labs.goo.ne.jp\t1419264063\t0"
}

shortsum

将提交的日语评论总结为简短摘要。

另请参阅 https://labs.goo.ne.jp/api/2015/1305/

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.shortsum(
     review_list=[
        "機能は限られていますが、必要十分でしょう。",
        "価格も安いと思います。お店の対応もよかったです。",
        "このシリーズを買うの3台目になりました。黒の発色が綺麗です。"
        "値段を考えれば十分すぎる性能で",
     ]
)

# All the arguments of this func.
api.shortsum(
     request_id="shortsum-req001",
     review_list=[
        "機能は限られていますが、必要十分でしょう。",
        "価格も安いと思います。お店の対応もよかったです。",
        "このシリーズを買うの3台目になりました。黒の発色が綺麗です。"
        "値段を考えれば十分すぎる性能で",
     ],
     length=60  # 60 or 120 or 180
 )

示例响应。

{
  "length": 60,
  "summary": "黒の発色が綺麗です。機能は限られていますが、必要十分でしょう。価格も安いと思います。",
  "request_id": "shortsum-req001"
}

keyword

从包含标题和正文的输入文档中提取“日语关键词”，例如人名、地点名等。

另请参阅 https://labs.goo.ne.jp/api/2015/1325/

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.keyword(
    title="「和」をコンセプトとする 匿名性コミュニケーションサービス「MURA」",
    body="NTTレゾナント株式会社（本社：東京都港区、代表取締役社長：若井 昌宏",
)

# All the arguments of this func.
api.keyword(
    request_id="keyword-req001",
    title="「和」をコンセプトとする 匿名性コミュニケーションサービス「MURA」",
    body="NTTレゾナント株式会社（本社：東京都港区、代表取締役社長：若井 昌宏",
    max_num=10,
    forcus="ORG",
)

示例响应。

{
  "keywords": [
    {"和": 0.5893},
    {"コンセプト": 0.5893},
    {"匿名性": 0.5893},
    {"コミュニケーションサービス": 0.5893},
    {"MURA": 0.5893},
    {"NTTレ ゾナント株式会社": 0.35},
    {"本社": 0.35}, {"東京都港区": 0.35},
    {"代表取締役社長": 0.35},
    {"若井": 0.35}
  ],
  "request_id": "labs.goo.ne.jp\t1457928295\t0"
}

chrono

提取表示日期和时间的表达式，并规范化其值

另请参阅 https://labs.goo.ne.jp/api/jp/time-normalization

from goolabs import GoolabsAPI

app_id = "xxxxxxxxxxxxxxxxxxxx"
api = GoolabsAPI(app_id)

# See sample response below.
ret = api.chrono(
    sentence="今日の10時半に出かけます。",
)

# All the arguments of this func.
api.chrono(
    request_id="chrono-req001",
    sentence="今日の10時半に出かけます。",
    doc_time="2016-04-01T09:00:00",
)

示例响应。

{"request_id":"record007",,"datetime_list":}

{
  "datetime_list": [
    ["今日", "2016-04-01"],
    ["10時半", "2016-04-01T10:30"]
  ],
  "doc_time":"2016-04-01T09:00:00",
  "request_id": "labs.goo.ne.jp\t1457928295\t0"
}

其他提示

您可以看到您刚刚调用的HTTP响应。

api = GoolabsAPI(app_id)
api.morph(sentence=u"日本語を分析します。")

# api.response is a instance of "requests.Response".
print(api.response.status_code) # => 200
print(api.response.json()) # => raw json data.

命令行工具

$ goolabs
Usage: goolabs [OPTIONS] COMMAND [ARGS]...

  Command line tools for Goo labs API(https://labs.goo.ne.jp/api/).

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  chrono      Extract expression expressing date and time...
  entity      Extract unique representation from sentence.
  hiragana    Convert the Japanese to Hiragana or Katakana.
  keyword     Extract "keywords" from an input document.
  morph       Morphological analysis for Japanese.
  shortsum    Summarize reviews into a short summary.
  similarity  Scoring the similarity of two words.

设置环境变量GOOLABS_APP_ID

为了使用此cli，建议设置环境变量GOOLABS_APP_ID。

# write your shell setting files(ex ~/.bashrc).
export GOOLABS_APP_ID=xxxxxxxxxxxxxxx

您每次使用时都可以传递App id，但并不推荐。

$ goolabs morph --app-id xxxxx 日本語を分析します。

morph

$ goolabs morph --help
Usage: goolabs morph [OPTIONS] [SENTENCE]

  Morphological analysis for Japanese.

Options:
  -a, --app-id TEXT
  -r, --request-id TEXT
  -i, --info-filter TEXT  form,pos,read
  -p, --pos-filter TEXT   名詞,句点,格助詞..etc
  -f, --file FILENAME
  -j, --json / --no-json
  --help                  Show this message and exit.

示例用法。

$ goolabs morph 日本語を分析します。
日本語,名詞,ニホンゴ
を,格助詞,ヲ
分析,名詞,ブンセキ
し,動詞活用語尾,シ
ます,動詞接尾辞,マス
。,句点,＄

# more option
$ goolabs morph --info-filter form,pos,read --pos-filter 名詞,句点 日本語を分析します。

# specify a file as an alternative to the sentence
$ goolabs morph --file sentence.txt

# get raw json
$ goolabs morph --json --request-id req001 日本語
{
  "word_list": [
    [
      [
        "日本語",
        "名詞",
        "ニホンゴ"
      ]
    ]
  ],
  "request_id": "req001"
}

similarity

$ goolabs similarity --help
Usage: goolabs similarity [OPTIONS] QUERY_PAIR...

  Scoring the similarity of two words.

Options:
  -a, --app-id TEXT
  -r, --request-id TEXT
  -j, --json / --no-json
  --help                  Show this message and exit.

示例用法。

$ goolabs similarity ウィンドウズ windows
0.767982966647

# get raw json.
$ goolabs similarity --json --request-id req002 ウィンドウズ windows
{
  "score": 0.7679829666474438,
  "request_id": "req002"
}

hiragana

$ goolabs hiragana --help
Usage: goolabs hiragana [OPTIONS] [SENTENCE]

  Convert the Japanese to Hiragana or Katakana.

Options:
  -o, --output-type [hiragana|katakana]
  -a, --app-id TEXT
  -r, --request-id TEXT
  -f, --file FILENAME
  -j, --json / --no-json
  --help                          Show this message and exit.

示例用法。

$ goolabs hiragana 日本語
にほんご

# convert to Katakana
$ goolabs hiragana --output-type katakana 日本語
ニホンゴ

# specify a file as an alternative to the sentence
$ goolabs hiragana --file sentence.txt

# get raw json
$ goolabs hiragana --json --request-id req003 日本語
{
  "output_type": "hiragana",
  "converted": "にほんご",
  "request_id": "req003"
}

entity

$ goolabs entity --help
Usage: goolabs entity [OPTIONS] [SENTENCE]

  Extract unique representation from sentence.

Options:
  -c, --class-filter TEXT  ART,ORG,PSN,LOC,DAT
  -a, --app-id TEXT
  -r, --request-id TEXT
  -f, --file FILENAME
  -j, --json / --no-json
  --help                   Show this message and exit.

示例用法。

$ goolabs entity 佐藤氏、2014年12月に足の小指骨折し豊洲の病院へ
佐藤,PSN
2014年12月,DAT
豊洲,LOC

# more option
$ goolabs entity --class-filter PSN,LOC 佐藤氏、2014年12月に足の小指骨折し豊洲の病院へ

# specify a file as an alternative to the sentence
$ goolabs entity --file sentence.txt

# get raw json
$ goolabs entity --json --request-id req004 佐藤氏
{
  "ne_list": [
    [
      "佐藤",
      "PSN"
    ]
  ],
  "request_id": "req004"
}

shortsum

$ goolabs shortsum --help
Usage: goolabs shortsum [OPTIONS] [REVIEW]

  Summarize reviews into a short summary.

Options:
  -a, --app-id TEXT
  -l, --length [60|120|180]
  -r, --request-id TEXT
  -f, --file FILENAME
  -j, --json / --no-json
  --help                  Show this message and exit.

示例用法。

$ goolabs shortsum このシリーズを買うの3台目になりました。黒の発色が綺麗です
黒の発色が綺麗です。

# more option
$ goolabs shortsum --length 180 黒の発色が綺麗です...

# specify a file as an alternative to the review
$ goolabs shortsum --file review.txt

# get raw json
$ goolabs shortsum --json --request-id req005 このシリーズを買うの3台目になりました。黒の発色が綺麗です
{
  "length": 120,
  "summary": "黒の発色が綺麗です。",
  "request_id": "req005"
}

keyword

$ goolabs keyword --help
Usage: goolabs keyword [OPTIONS] TITLE [BODY]

  Extract "keywords" from an input document.

Options:
  -a, --app-id TEXT
  -m, --max_num INTEGER
  -fo, --forcus [ORG|PSN|LOC]
  -r, --request-id TEXT
  -f, --file FILENAME
  -j, --json / --no-json
  --help                       Show this message and exit.

示例用法。

$ goolabs keyword "匿名性コミュニケーションサービス「MURA」" "NTTレゾナント株式会社"
匿名性,0.6
コミュニケーションサービス,0.6
MURA,0.6
NTTレゾナント株式会社,0.4

# more option
$ goolabs keyword --max_num 2 --forcus ORG "匿名性コミュニケーションサービス「MURA」" "NTTレゾナント株式会社"

# specify a file as an alternative to the body
$ goolabs keyword  --file body.txt "匿名性コミュニケーションサービス「MURA」"

# get raw json
$ goolabs keyword --json --request-id req006 "匿名性コミュニケーションサービス「MURA」" "NTTレゾナント株式会社"
{
  "keywords": [
    { "匿名性": 0.6 },
    { "コミュニケーションサービス": 0.6 },
    { "MURA": 0.6 },
    { "NTTレゾナント株式会社": 0.4 }
  ],
  "request_id": "req006"
}

chrono

$ goolabs chrono --help
Usage: goolabs chrono [OPTIONS] [SENTENCE]

 Extract expression expressing date and time and normalize its value

ptions:
 -a, --app-id TEXT
 -r, --request-id TEXT
 -d, --doc-time TEXT
 -f, --file FILENAME
 -j, --json / --no-json
 --help                  Show this message and exit.

示例用法。

$ goolabs chrono "今日の10時半に出かけます。"
今日: 2017-05-29
10時半: 2017-05-29T10:30

# more option
$ goolabs chrono -d "2016-04-01T09:00:00"  "今日の10時半に出かけます。"
今日: 2016-04-01
10時半: 2016-04-01T10:30

# specify a file as an alternative to the body
$ goolabs chrono --file sentence.txt

# get raw json
$ goolabs chrono --json --request-id req007 "今日の10時半に出かけます"
{
  "datetime_list": [
    [
      "今日",
      "2017-05-29"
    ],
    [
      "10時半",
      "2017-05-29T10:30"
    ]
  ],
  "doc_time": "2017-05-29T12:36:33",
  "request_id": "req007"
}

Python支持

Python 2.6, 2.7, 3.3, 3.4或更高版本。

使用

Goo labs API .

许可

此库的源代码采用MIT许可证授权。
您必须遵守条款使用Goo labs API

有关具体条款，请参阅LICENSE.rst文件。

作者

tell-k <ffk2005 at gmail.com>

历史

0.4.0（2017年5月30日）

添加新API“chrono”。
添加对Python3.6的支持。
添加类型注解。

0.3.0（2016年3月14日）

添加新API“keyword”。

0.2.2（2015年7月12日）

为“goolabs shortsum”命令添加“-l”选项。

0.2.0（2015年7月12日）

添加新API“shortsum”。
改进单元测试代码

0.1.2（2015年1月1日）

从安装的包中排除测试代码

0.1.1（2014年12月31日）

为命令行工具添加单元测试。

0.1.0（2014年12月25日）

首次发布

项目详情

这些详情尚未由PyPI验证

项目链接

主页

发布历史发布通知 | RSS源

此版本

0.4.0

2017年5月30日

0.3.0

2016年3月14日

0.2.2

2015年7月12日

0.2.1

2015年7月12日

0.2.0

2015年7月11日

0.1.2

2015年1月1日

0.1.1

2014年12月31日

0.1.0

2014年12月24日

下载文件

下载适合您平台的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。

源代码发行版

goolabs-0.4.0.tar.gz （16.0 kB 查看哈希值）

上传时间 2017年5月30日 源代码

构建发行版

goolabs-0.4.0-py2.py3-none-any.whl （15.3 kB 查看哈希值）

上传时间 2017年5月30日 Python 2 Python 3

哈希值 for goolabs-0.4.0.tar.gz

哈希值 for goolabs-0.4.0.tar.gz
算法	哈希摘要
SHA256	`4f768a5b98960c507f5ba4e1ca14d45e3139388669148a2750d415c312281527`
MD5	`ea0d679748a4cf699a3813c5949444af`
BLAKE2b-256	`ce862d3b5bd85311ee3a7ae7a661b3619095431503cd0cae03048c646b700cad`

哈希值 for goolabs-0.4.0-py2.py3-none-any.whl

哈希值 for goolabs-0.4.0-py2.py3-none-any.whl
算法	哈希摘要
SHA256	`fd66d8eb8a5824c8481b2325ea3ecc8e3feea6816ea4670af0850463e1be149b`
MD5	`f92ca2485b5fd3e68be6b25172d8f282`
BLAKE2b-256	`2e06c3c480103d0880b726711dee8650fafbfa847152d11fc298de0dace56e4e`

goolabs 0.4.0

导航

已验证详情

维护者

未验证详情

项目链接

元数据

分类

项目描述

morph

similarity

hiragana

entitiy

shortsum

keyword

chrono

其他提示

设置环境变量GOOLABS_APP_ID

morph

similarity

hiragana

entity

shortsum

keyword

chrono

0.4.0（2017年5月30日）

0.3.0（2016年3月14日）

0.2.2（2015年7月12日）

0.2.0（2015年7月12日）

0.1.2（2015年1月1日）

0.1.1（2014年12月31日）

0.1.0（2014年12月25日）

项目详情

已验证详情

维护者

未验证详情

项目链接

元数据

分类

发布历史 发布通知 | RSS源

下载文件

源代码发行版

构建发行版

发布历史发布通知 | RSS源